APIService_XML_JSON_JAVA_Servlet

apiservice_xml_json_java_servlet

XMLファイルに保存され、APISERVLET GETメソッドにマッピングされ、JSONアレイを返すユーザーデータをクエリするためのAPIサービスの実装

API

アプリケーションプログラミングインターフェイスまたはAPIは、2つのアプリケーションが相互に「通信」できるようにするソフトウェア仲介者です。携帯電話でアプリケーションを使用する場合、これが起こることです。

• アプリケーションはインターネットに接続し、データをサーバーに送信します。
• 次に、サーバーはそのデータを取得し、それを解釈し、必要なアクションを実行し、携帯電話に送り返します。
• 次に、アプリケーションはそのデータを解釈し、読み取り可能な形式で必要な情報を提示します。これはすべてAPIを介して行われます。

タスクの詳細

あなたのタスクは、 com.he.api.data.xmlに次の形式で保存されているユーザーデータを照会するためにAPIサービスを実装することです。

    <dataset id_auto_increment="3"› 
      <user id="1" firstName="John" lastName="Dawson"/> 
      <user id="2" firstName="John" lastName="Doe"/> 
    </dataset>

• <dataset>タグは、XMLドキュメントのルート要素です。単一の属性id_auto_incrementがあります。 IDの値は次のように増加します：最後に追加されたユーザーのIDの値 + 1

• <user />タグは、データセットのユーザーレコードを表します。次の属性があります：

  • ID：ユーザーデータの主キー。整数値です。
  • FirstName：ユーザーの名。これは、英語のアルファベットの小文字と大文字のみを含む文字列値です。
  • iastname：ユーザーの姓。これは、英語のアルファベットの小文字と大文字のみを含む文字列値です。

サーバーへの呼び出しはscheme://domain:port/API?action=#&id=#&firstName=#&lastName=# 、 "string 'after'？ 'クエリ文字列を示します。

Apiservlet （com.he.api.apiservlet.java）にマッピングされたAPIサービスを実装する必要があります（url scheme ：// domain：port/api）クエリ文字列（クエリ文字列の詳細については、こちらをご覧ください）には、次のパラメーターがあります。

• アクション：実行する必要がある操作を定義します
• id
• ファーストネーム
• iastname

クエリの種類

クエリは次のタイプを使用できます。

• action = searchByld＆id =＃ ：data.xmlファイルのデータセットでIDで検索します。選択したユーザーを含むJSONアレイを応答として返します。

サンプルURL： scheme://domain:port/API?action=searchById&id=1

応答：

  [{ 
    "id": 1, 
    "firstName": "John", 
    "lastName": "Dawson" 
  }l 

• action = searchbyfirstname＆firstName =＃ ：data.xmlファイルのデータセットでfirstNameで検索します。選択したユーザーを含むJSONアレイを応答として返します。

例URL： scheme://domain:port/API?action=searchByFirstName&firstName=John

応答：

  [{ 
    "id": 1, 
    "firstName": "John", 
    "lastName": "Dawson" 
  }, { 
    "id": 2, 
    "firstName": "John", 
    "lastName": "Doe" 
  }] 

• action = searchbyfirstname＆iastname =＃ ：data.xmlのデータセットでlastNameで検索します。選択したユーザーを含むJSONアレイを応答として返します。

例URL： scheme://domain:port/API?action=searchByLastName&lastName=Doe

応答：

  [{ 
    "id": 2, 
    "firstName": "John", 
    "lastName": "Doe" 
  }] 

• action = searchByldrange＆low =＃＆high =＃ ：data.xmlファイルのデータセットでIDで検索します。 IDが応答として[低、高]範囲にある選択したユーザーを含むJSONアレイを返します。

サンプルURL： scheme://domain:port/API?action=searchByIdRange&low=1&high=2

応答：

  [{ 
    "id": 1, 
    "firstName": "John", 
    "lastName": "Dawson" 
  }, { 
    "id": 2, 
    "firstName": "John", 
    "lastName": "Doe" 
  }] 

• action = updateUser＆id =＃＆firstName =＃＆lastName =＃ ：data.xmlファイルでユーザーを更新します。 FirstNameまたはIastNameパラメーターが存在しない場合、値は変更されません。 FirstNameのみが存在し、LastNameがnullである可能性があり、FirstNameのみを更新する必要があります。

例URL： scheme://domain:port/API?action=updateUser&id=1&firstName=James&lastName=Jackson

  <dataset id auto increment="3"> 
    <user id="1" firstName="James" lastName="Jackson"/> 
    <user id="2" firstName="John" lastName="Doe"/> 
  </dataset> 

• action = insertuser＆firstName =＃＆iastName =＃ ：次のパラメーターを使用して、data.xmlファイルにユーザーレコードを挿入します。
  • ファーストネーム
  • iastname

ユーザーのIDは、ルートデータセットタグのID_AUTO_INCREMENTパラメーターによって指定されます。値が挿入された後、ID_AUTO_INCREMENTパラメーターは1で増加します。

例URL： scheme://domain:port/API?action=insertUser&firstName=James&lastName=Jackson

  <dataset id auto increment="4"> 
    <user id="1" firstName="John" lastName="Dawson"/> 
    <user id="2" firstName="John" lastName="Doe"/>
    <user id="3" firstName="James" lastName="Jackson"/>
  </dataset> 

テスト

JSONアレイとXML Domのマッピングを比較して、API実装をテストします。