Node.js プログラミングと組み合わせた Java 開発者向けの入門チュートリアル

まず第一に、私は 10 年以上の開発経験を持つ Java 開発者として、多くの問題を解決するための固有のルーチンを作成してきたことを認めなければなりませんが、それらは多くの場合面倒で面倒に見えます。 たとえば、ファイルを読み取りたい場合は、BufferedReader インスタンスを初期化し、FileReader に渡す必要があります。これは、私が「エンタープライズ レベル」であると考えている多くのプロジェクトでこのようなコードを作成しており、非常に楽しんでいるからです。プロセスとしては、私は他の言語を軽視する単なる Java 愛好家であると言えます。

このブログ記事を読んでいるあなたは、私が何年も前に陥っていた誤解に陥っているかもしれません。資格のある開発者として、常に新しいテクノロジを学習し、実際の作業のニーズに基づいて適切なテクノロジを選択する必要があります。とはいえ、私も年をとっているので、いつか Java に飽きてしまうかもしれません。しかし、私は今、本当にエキサイティングな新しいことを発見しました。node.js は、私にとって新しいおもちゃを手に入れた子供のようなものです。このブログ投稿では、最初に Java EE サービスを使用して MongoDB データベースを読み取るための単純な REST を作成する方法を説明します。次に、node.js を使用して同じ機能を実現します。この新しい開発言語の魅力をより簡単に理解できるでしょう。

基本から始めましょう - Node.js とは何ですか?

まず最初に明確にしておきたいのは、Node.js は「おしゃれな人」だけが使う「おしゃれな」言語ではないということです。このような理解から始まりましたが、Node.js は成熟した言語であることを嬉しく思います。現在のインターネット時代では、トラフィックの最も多い Web サイトの一部に Node.js が導入されています。 Node.js はあなたのスキルセットにとって非常に便利なツールであり、安定性、安全性、パフォーマンスの高いコードをいかに簡単に構築できるかに驚かれるでしょう。

つまり、Node はサーバー側のアクティビティのための言語です。 Javascript言語を使用しており、npmモデルなど多くのライブラリが利用可能です。これらの npm モデルを Java の .jar パッケージと比較できます。機能の一部が必要だが、すべてのコードを自分で書く気がしない場合、探している機能がすでに npm モデルで提供されている可能性があります。

ノード アプリケーションは通常、ノンブロッキング I/O と非同期イベントを利用して効率を最大化するように実行されます。 Java 開発者が知っておく必要があることの 1 つは、Node アプリケーションが単一のスレッドで実行されるということです。ただし、バックエンド ノード コードは、ネットワークやファイル アクセスなどの操作に複数のスレッドを使用します。このため、Node はリアルタイム エクスペリエンスを必要とするアプリケーションに最適です。

続行 - IDE サポート

あなたも私と同じように、IDE で「生きて」「呼吸」しているかもしれません。これは、Java が冗長であり、ソフトウェア開発プロセス中に機能を完了するために一定のコードを記述する必要があるという事実によるものかもしれません。コード補完の利点を発見すると、ファイル管理、デバッグ、その他の非常に便利な機能に IDE を使用する方法をゆっくりと学びました。これだけ言えば、私は IDE を使うのが大好きで、Nodeb を使用するときは IDE を使い続けています。現在 Node をサポートしている IDE の最初のバッチは次のとおりです。

1. Eclipse - Java ですでに使用している場合は、簡単に使い始めることができます。 Node.js プラグインをインストールするだけです。
2.JetBrains IntelliJ IDEA - 非常に人気のある商用 IDE。これは今のところ私のお気に入りの IDE です。
3.Microsoft Visual Studio – はい、その通りです。 Node は、Microsoft が Visual Studio にネイティブ サポートを追加するまでに成長しました。この実装は非常に安定しており、VS は私の 2 番目に好きな IDE です。奇妙なことに、私はいくつかの基本的な Node プロジェクトでのみ VS を使用します。
4.CodeEnvy - Web ベースの IDE
5.Cloud9 - WebベースのIDE
6.SublimeText 2 - 軽量な性質のため、開発者の間でますます人気が高まっている飾り気のないテキスト エディターです。

これらは、ノードベースのプロジェクトで作業するための私のお気に入りの IDE の一部です。ほんの一例です。

例から始めましょう

このブログ投稿の残りの部分では、Java EE と Node.js を使用して単純な REST サービスを作成します。この REST サービスは、単に MongoDB データベースから情報を読み取り、結果をリクエスターに返します。 Java アプリケーション サーバーと MongoDB データベースのインストールと構成については、この記事の範囲外です。

Java アプリケーションを作成する

ステップ 1: pom.xml ファイルを構成する

この例をrestexample と呼び、JBoss EAP アプリケーションサーバーを使用します。最初に行う必要があるのは、Maven ビルド システムを使用して依存関係管理用に pom.xml ファイルを構成することです。以下は、restexample アプリケーションで必要な依存関係を含む pom.xml ファイルです。

 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http:/ /maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>restexample</groupId> <artifactId>restexample</artifactId> <packaging>war</packaging> <version>1.0</version> <name>restexample</name> <リポジトリ> <リポジトリ> <id>eap</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>eap</ id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven .compiler.source>1.6</maven.compiler.source> <maven.compiler.target>1.6</maven.compiler.target> </properties> <dependency> <dependency> <groupId>org.jboss.spec</groupId> <artifactId>jboss-javaee-6.0</artifactId> <version>3.0.2.Final-redhat-4</version> <type>pom</type> <scope>provided</scope> </dependency> <dependency> <groupId>org.mongodb</groupId> <artifactId>mongo-java-driver</artifactId> <version>2.9.1</version> </dependency> </dependency> </project>

とても詳しく書かれていますが、このブログ投稿では読者がすでに Java を知っていることを前提としているため、詳細については説明しません。

ステップ 2:Beans.xml ファイルを作成し、サーブレット マッピングを設定する

例の一部として、データベース アクセス クラスで CDI (コンテキスト依存性注入) を使用します。公式の CDI 構成手順によると、アプリケーションで CDI を使用する場合は、アプリケーションの WEB-INF ディレクトリに beans.xml ファイルを含める必要があります。このファイルを作成し、必要な情報を設定してみましょう。 /src/main/webapp/WEB-INF ディレクトリに移動し、beans.xml ファイルを作成し、次のコードを追加します。

 <?xml version="1.0"?><beans xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-インスタンス" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://jboss.org/schema/cdi/beans_1_0.xsd"/>

また、web.xml ファイルで RESI API のサーブレット マッピングを設定する必要があります。次のサーブレット マッピング要素を /src/main/webapp/WEB-INF ディレクトリ内のファイルに追加します。

 <servlet-mapping> <servlet-name>javax.ws.rs.core.Application</servlet-name> <url-pattern>/ws/*</url-pattern></servlet-mapping>

ステップ 3: DBConnection クラスを作成する

この時点で、プロジェクトはセットアップされており、pom.xml ファイルには MongoDB データベースのドライバー依存関係がすでに含まれています。必要なドライバーがアプリケーションにパッケージ化されていることを確認してください。次に行う必要があるのは、データベース接続を管理するクラスを作成することです。 DBConnection.java という名前の新しいファイルを作成し、このファイルを /src/main/java/com/strongloop/data ディレクトリに配置して、このファイルに次のコードを追加します。

注: MongoDB データベースのインストールが適切な接続承認の詳細で構成されていることを確認してください。

パッケージ com.strongloop.data; インポート javax.annotation.PostConstruct; インポート com.mongodb.Mongo; ; @Named@ApplicationScopedpublic クラス DBConnection {プライベート DB mongoDB; DBConnection() { super(); } @PostConstruct public void afterCreate() { String mongoHost = "127.0.0.1" String mongoPort = "27001" String mongoUser = "strongloop; String mongoPassword = "rocks"; String mongoDBName = "restexample" ; int ポート = Integer.decode(mongoPort); null; try { mongo = new Mongo(mongoHost, port); } catch (UnknownHostException e) { System.out.println("MongoDB に接続できませんでした: " + e.getMessage() + " :: " + e. getClass()); } mongoDB = mongo.getDB(mongoDBName) if (mongoDB.authenticate(mongoUser, mongoPassword.toCharArray()) == false) { System.out.println("DB の認証に失敗しました ") } } public DB getDB() { return mongoDB;

ステップ 4: データを MongoDB にインポートする (うーん、ビール)

私たちのプロジェクトでは、Pabst という名前のすべてのビールのリストをロードしたいと考えています。ビール業界に不慣れな方は、パブスト ブリューイングのアメリカン ライト エールを試してみてはいかがでしょうか。これらのビールはブルーのリボンとコルトのデザインが特徴で、あらゆる種類の麦芽飲料が含まれています。

まず、返す必要のあるすべてのデータを含む json ファイルをダウンロードする必要があります。これを実現するには、次の URL を使用できます。
https://dl.dropboxusercontent.com/u/72466829/beers.json

ダウンロード後、mongoimport コマンドを使用してデータベースにインポートします。コマンドは次のとおりです。

 $ mongoimport --jsonArray -d yourDBName -c beers --type json --file /tmp/beers.json -h yourMongoHost --port yourMongoPort -u yourMongoUsername -p yourMongoPassword

次の結果が表示されます。

接続先: 127.0.0.1:27017火曜日 6 月 10 日 20:09:55.436 チェック 9 24火曜日 6 月 10 日 20:09:55.437 24 個のオブジェクトをインポートしました

ステップ 5: Beer モデル オブジェクトを作成する

データベース接続クラスを作成し、ビール情報を MongoDB データベースにロードしました。次に、ビール情報を制御するモデル オブジェクトを作成します。 Beer.java という名前の新しいファイルを作成し、/src/main/java/com/strongloop/data ディレクトリに配置します。ファイルを作成したら、次のコードをそれに追加します。

パッケージ com.strongloop.data; パブリック クラス ビール { プライベート ストリング ID; プライベート ストリングの説明; パブリック String getId(String id) { this.id = id; getName() { 名前を返します。 } public void setName(String name) { this.name = 名前; } public String getDescription() { 説明を返します。 this.description = 説明 }}

注: 提供された JSON ファイルには、使用する詳細な情報が含まれているため、それを確認して追加機能を追加し、学習体験を広げてください。

ステップ 6: REST サービスを作成する

どうすればいいでしょうか？これで、前のステップでロードされたビール情報を取得できる REST ベースの Web サービスを作成する準備が整いました。これを行うには、BeerWS.java という新しいファイルを作成し、/src/main/java/com/strongloop/webservice ディレクトリに配置する必要があります。作成後、次のコードを追加します。

パッケージ com.strongloop.webservice; インポート java.util.ArrayList;インポート java.util.List;インポート javax.enterprise.context.RequestScoped;インポート javax.inject.Inject;インポート javax.ws.rs.GET;インポート javax.ws .rs.Path;import javax.ws.rs.Produces;import javax.ws.rs.QueryParam;import com.strongloop.data.DBConnection;インポート com.strongloop.data.Beer;インポート com.mongodb.BasicDBObject;インポート com.mongodb.DB;インポート com.mongodb.DBCollection;インポート com.mongodb.DBCursor;インポート com.mongodb。 DBObject; @RequestScoped@Path("/beers")public class BeerWS { @Inject private DBConnection dbConnection; private DBCollection getBeerCollection() { DB db = dbConnection.getDB(); DBCollection beerCollection("beers"); private ビール PopulateBeerInformation(DBObject dataValue) { ビール theBeer = 新しいビール(); theBeer.setName(dataValue.get("name")); theBeer.setDescription(dataValue.get("name")); theBeer.setId(dataValue.get("_id").toString()); // すべてのビールを取得 @GET() @Produces("application/json") public List<Beer> getAllBeers() { ArrayList<Beer> allBeersList = new ArrayList<Beer>(); DBCollection ビール = this.getBeerCollection(); DBCursor カーソル = beers.find(); try { while (cursor.hasNext()) { allBeersList.add(this.populateBeerInformation(cursor.next) ())); } } 最後に {cursor.close() };

ステップ 7: ビールの情報を閲覧する

ああ、終わった。データベースからすべてのビール情報を取得できる REST サービスを作成しました。コードをアプリケーション サーバーにデプロイするには、ブラウザで次のアドレスを開いて、正常に動作するかどうかを確認します。
http://サーバーの場所/ws/beers

何も問題がなければ、以下に示すように、すべてのビール情報のリストが表示されます。

ノードアプリケーションの作成

上記の手順に従って Java でプログラミングすると、JavaEE を使用したアプリケーションの作成は急速に進んでいますが、REST サービスのような単純なアプリケーションを作成するのは依然として非常に面倒であることがわかります。誤解しないでください。私は今でも javaEE を使用するのが好きですが、json データを返す REST サービスの作成など、多くのシナリオでは Node の方が適していると感じています。次に、StrongLoop の LoopBack API を使用して簡単な Web サービスを作成します。さらに、Apple OSX に Node をインストールする方法も説明します。

ステップ 1: ノードのインストール

Node をインストールする最も簡単な方法は、ほとんどのオペレーティング システムと互換性のあるバイナリ パッケージを使用することです。ブラウザを開いて以下の Web ページにアクセスし、オペレーティング システムに応じて該当するバージョンをダウンロードします。
http://nodejs.org/download/

ダウンロードが完了すると、次の内容が表示されます。

Mac OSX を使用している場合は、汎用の .pkg ファイルをクリックします。これにより、インストーラーがコンピューターに保存されます。ファイルをダウンロードした後、それをダブルクリックしてインストール プログラムを開始すると、次のインストール ダイアログ ボックスが表示されます。

インストールが成功したら、デフォルトでインストールを続行し、「閉じる」ボタンをクリックしてインストール プログラムを終了します。

とてもシンプルですよね？

ステップ 2: NPM を使用して LoopBack をインストールする

Node がローカル システムにインストールされたので、次のステップは StroopLoop が提供する LoopBack パッケージをインストールすることです。 LoopBack はオープン API ソース コード パッケージであり、Node を使用してソフトウェアを開発およびデプロイする方法を学ぶと、LoopBack を使用してプログラミングが容易になります。

LoopBack をインストールするには、コア Node 言語の一部である npm コマンド ラインを使用します。 NPM は、アプリケーションが依存するクラス ライブラリまたはテンプレートをインストールするために使用される公式のパッケージ管理ツールです。 Java プログラマーであれば、NPM を Maven と比較することができます。 Maven を使用してプロジェクトを構築すると、開発者はプロジェクトが依存する jar パッケージまたはテンプレートを pom.xml で構成できます。プロジェクトのコンパイルが開始されると、Maven はすべての依存ファイルをダウンロードし、jar パッケージをプロジェクトに導入します。 NPM は、Maven と同じように機能します。一部の特殊なプロジェクトでは、package.json ファイルを使用して、プロジェクトが依存するファイルを構成します。コマンド ラインを使用して、依存ファイルをローカル システムにダウンロードすることもできます。これを理解できなくても、心配しないでください。次の手順で package.json ファイルについて詳しく説明します。

LoopBack をインストールするには、単純なコマンド ラインを使用して、すべての依存ファイルをダウンロードしてインストールします。ウィンドウのコマンド ライン ウィンドウを開き、次のコマンドを入力します。

 $ npm install -g Strongloop

ヒント: インストール中に、このコマンドを実行するには別のユーザー アカウントを使用する必要がある場合があります。

このコマンドラインは何を意味するのでしょうか? -g パラメーターは、npm にstrong-cli パッケージをインストールすることを指示します。 -g パラメータにより、このパッケージはあらゆるシステムおよびアプリケーションと互換性があります。上記のコマンドを実行すると、NPM はすべての依存ファイルをダウンロードします。ダウンロード時間はインターネットの速度によって異なり、数分かかる場合があります。

ステップ 3: アプリケーションを作成する

LoopBack API を使用したアプリケーションの作成は簡単です。 ウィンドウのコマンド ライン ウィンドウを開き、次のコマンドを使用して新しいアプリケーションのレストサンプルを作成します。

 $ slc ループバック

次に、プロジェクトのルート パスの名前の入力を求められます。 この例では、restexample が使用されます。 次に、アプリケーション名の入力を求められます。 デフォルトのrestexampleを使用してください。

slc コマンドにより、restexample という名前の LoopBack アプリケーションが作成され、アプリケーションが構成されました。 上記のコマンドを再度実行し、依然としてrestexampleを使用して名前を付けると、LoopBackは新しいディレクトリを作成します。 cd コマンドを使用して、アプリケーションのルート パスを変更できます。

 $ cd レスト例

アプリケーションを作成したので、MongoDB をアプリケーションのデータ ソースとして構成します。

ステップ 4: データ ソースを定義する

MongoDB に接続するには、データ ソースをアプリケーションに追加し、次のコマンドを実行する必要があります。

 $ slc ループバック:データソース

ポップアップ プロンプトで、カスタマイズされたデータ ソース名を入力できます。ここでは、myMongo を選択します。

 [?] データソース名を入力してください: myMongo

このようにして、バックエンドのデータ ソース定義を StrongLoop を利用した実際のコネクタに接続します。ここでは、リストから MongoDB コネクタを選択します。

 [?] myMongo のコネクタを選択します:PostgreSQL (StrongLoop でサポート)Oracle (StrongLoop でサポート)Microsoft SQL (StrongLoop でサポート)MongoDB (StrongLoop でサポート)SOAP Web サービス (StrongLoop でサポート)REST サービス (StrongLoop でサポート)Neo4j (コミュニティによって提供されます)(上下に移動すると、より多くの選択肢が表示されます)

ステップ 5: 実際のデータ ソースを指定する

MongoDB に接続するには、LoopBack が datasource.json ファイル内のすべてのデータ ソース構成情報を定義する必要があります。このファイルはアプリケーションの root/server ディレクトリにあります。次のように、MongoDB はデータ ソースを追加します。

 { "db": { "name": "db", "connector": "memory" }, "myMongo": { "name": "myMongo", "connector": "mongodb" "url": "mongodb: //localhost:27017/restexample" }}

注: MongoDB データベースへの正しい接続 URL を必ず指定してください。この例では、データ ソースとして使用するrestexample という名前のデータベースを作成しました。

ステップ 6: データを MongoDB にインポートする (うーん、ビール)

この記事の Java 部分で説明したように、この記事で説明した方法に従ってこのステップを完了し、同じデータベースを使用する予定がある場合は、このステップを無視できます。 6 をクリックし、ステップ 7 に直接ジャンプします。

まず、返されるすべての情報を含む JSON ファイルをダウンロードする必要があります。このファイルは次の URL から取得できます。
https://dl.dropboxusercontent.com/u/72466829/beers.json

データ セット ファイルをダウンロードした後、次の mongoimport コマンドを直接使用して、データ セット ファイルをデータベースにロードします。

 $ mongoimport --jsonArray -d yourDBName -c beers --type json --file /tmp/beers.json -h yourMongoHost --port

次の結果が表示されるはずです。

接続先: 127.6.189.2:27017火曜日 6 月 10 日 20:09:55.436 チェック 9 24火曜日 6 月 10 日 20:09:55.437 24 個のオブジェクトをインポートしました

ステップ 7: 独自のビールモデルを作成する

Java の世界では、このオブジェクトを表すオブジェクト モデルを考えることができますが、LoopBack は、コマンド ラインを介してモデル オブジェクトを作成する簡単な方法を提供します。次のコマンドを入力します。

 $ slc ループバック:モデル

これにより、モデルを定義するための対話型セッションが開きます。最初に入力する必要があるのはモデル名です。次に、このモデルをアタッチするデータ ソースの入力を求められます。以前に作成した myMongo データ ソース。

 [?] モデル名を入力してください: beer[?] ビールを添付するデータソースを選択してください:db (memory)myMongo (mongodb)

次に、この API を REST 経由で公開するかどうかを尋ねられます。もちろん、ここでは公開することを望みます。

 [?] REST API 経由でビールを公開しますか? はい

最後に、モデルのネットワーク複数名を選択します。ここではモデルの名前が beer であるため、Enter キーを押してデフォルトを受け入れます。

 [?] カスタム複数形 (REST URL の構築に使用):

次に、モデルのプロパティを定義するように求められます。このサンプル プログラムでは、ビールの名前と説明に焦点を当てます。

完了したら、空のプロパティ名を入力してください。[?] プロパティ名: 名前

Enter キーを押すと、指定した各属性のデータ型を入力するように求められます。最初の項目は文字列型を選択し、次に押します。

 Enter.[?] プロパティの種類: (矢印キーを使用)stringnumberbooleanobjectarraydatebuffergeopoint(other)

次に、同じ方法で description 属性を作成すると、データ型を入力するように求められます。これは文字列型でもあり、文字列オプションを選択して、クリックします。

 Enter.別のビールプロパティを追加しましょう。完了したら、空のプロパティ名を入力してください。[?] プロパティ名: descriptioninvoke loopback:property[?] プロパティの種類: string[?] 必須ですか?

おめでとうございます! LoopBack と Node を組み合わせたモデル オブジェクトの作成が完了しました。このプロセス中に実際に何が作成されたかを確認したい場合は、アプリケーションの root/common/models ディレクトリにある beer.json ファイルを開いて、次の場所までスクロールします。ファイルの最後に、次のモデルが表示されます。

 { "name": "beer", "base": "PersistedModel", "properties": { "name": { "type": "string", "required": true }, "description": { "type" : "文字列"、"必須": true } }、"検証": []、"関係": {}、"acls": []、"メソッド": []}

ここでわかるように、モデルを作成しました。同時に、名前と説明の属性がこのモデルに割り当てられました。

/server/model-config.js ファイルには、public フィールドや datasource などの追加フィールドが含まれていることがわかります。public フィールドは、REST ネットワーク サービスを通じてこのモデルを外部に公開することを指定します。フィールドは、このモデルの CRUD 操作に使用されるデータ ソースを指定します。

 "ビール": { "dataSource": "myMongo", "public": true }

ステップ8: ビールを見る喜びに浸る

おめでとうございます! ビール情報を取得できる REST Web サービスを含む最初の Node.js アプリケーションが作成されました。最後に必要なのは、アプリケーションをデプロイすることだけです。

幸いなことに、アプリケーションのルート ディレクトリで次のコマンドを実行することで、デプロイメントをすでに簡単に行うことができます。

 $ slc 実行

アプリケーションが実行されたらすぐに、ブラウザで次の URL にアクセスして、デプロイが成功したかどうかを確認できます。

http://0.0.0.0:3000/api/beers

かなりクールですね。

LoopBack には、作成したビール モデルや REST サービスなど、アプリケーションで利用可能なすべてのサービスを表示できるページも含まれています。ブラウザで次の URL を参照してください。

http://0.0.0.0:3000/エクスプローラー

ページが正常に読み込まれると、次のインターフェイスが表示されます。ブログの一部として Bean ノードを作成し、/beers エンドポイントを強調表示しました。

次の図に示すように、/beers をクリックして利用可能な API を展開し、操作してテストできます。

結論は

このブログ投稿では、Java EE を使用して、Pabst Beer Company からビール製品リスト データを返す REST サービスを作成する方法を示します。 その後、node.js と、node.js に基づくループバック フレームワークを使用して、非常に少ないコードで同じ機能を持つ REST サービスを実装しました。 最も重要なことは、LoopBack API はビール エンティティの追加、削除、チェック、変更のデフォルト実装も提供しているため、一行も記述することなく、完全な追加、削除、チェック、変更機能を備えた残りのサービスを取得できることです。コードの。

次のリストは、ブログ投稿で言及されている javaEE と Node.js のそれぞれの機能を比較しています。

次は何でしょうか？

次期 Node v0.12 では、少なくとも 8 つのエキサイティングな新機能が導入されます。それは何でしょうか?詳細については、「Node.js v0.12 の新機能」ページを参照してください。
Node 関連のトレーニングと認定に興味がありますか? StrongLoop は、ニーズを満たすさまざまなサービスを提供しています。