[Java] 33. オープンライブラリを参照する方法(eclipseからmavenを連結)

こんにちは。明月です。

この投稿はJavaのオープンライブラリを参照する方法(eclipseからmavenを連結)に関する説明です。

我々がプロジェクトを構成してプログラムを作成する時、すべてのアルゴリズムと構造体、parsingして変換する関数などのすべてのプログラムソースを作成しながらプログラムを作成することはできません。なぜならそうなら検証する領域も増えるし、作業ステップが多くなるからです。

それじゃなくてもネットから検証してないソースを使うこともリスクがあります。

例えば、プロジェクト内部でJsonタイプの構造体を使います。

Stringタイプになっているjsonデータをクラスに変換することやクラスタイプにあるデータをStringタイプのjsonデータに変換しようと思えばJava標準ライブラリでは変換クラスや関数がないので変換関数を作成しなければならないです。

作ったと思っても様々なケースを予想してテストや検証をしなければならないです。つまり、我々がやろうと思ったプロジェクトがあるのにその付属関数を作ることで時間がたくさんかかることになります。

それでApacheではよく使うソースなどをライブラリを公開しますが、それをオープンライブラリだといいます。

このオープンライブラリはmavenというプログラムとmaven repositoryを通ってオープンライブラリを簡単に検索してプロジェクトに自動に依存性チェックまでして連結することができます。

(依存性チェックとはAライブラリを参照します。でもAライブラリを使うためにはBとCのライブラリが必要です。それならmavenではAというプロジェクトだけ連結すれば自動にBとCライブラリまでダウンロードして連結する機能ということです。)

私もmavenの詳細な仕様はわからないですが、簡単にオープンライブラリを連結して使えるプログラムだということまで知っています。

他の言語ではC#のNugetがあるしPHPはcomposer、pythonにはpipがあります。

それならmavenをインストールしてeclipseに連結して使いましょう。(私はJavaを使う時によく使うツールはeclipseです。)

link - https://maven.apache.org

サイトでzipファイルをダウンロードしましょう。

そして適当なところで圧縮を解凍します。

そして「cmd」で当該なフォルダに行って「bin」フォルダで「mvc -version」を確認します。

その後で環境変数の設定をしましょう。Window key + Pause breakを押下するかドライブの属性を選択します。

環境設定を設定した後、「cmd」に行ってもう一回に確認します。

maven設定は完了しました。

mavenを「eclipse」に設定します。「eclipse」の「Preferences」タブに移動します。

そして「maven」をインストールしたフォルダを設定します。

これから「eclipse」で「maven」プロジェクトを生成します。

先は一般プロジェクトで生成しますね。

「maven」プロジェクトに変換します。

そうしたら「pom.xml」が生成されます。「maven」のテストのため、「gson」を追加します。

<dependencies>
  <!-- https://mvnrepository.com/artifact/com.google.code.gson/gson -->
  <dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.5</version>
  </dependency>
</dependencies>

pom.xmlを作成してライブラリをアップデータします。

テストのため、ソースを作成しましょう。

import com.google.gson.Gson;
// 実行クラス
public class Example {
  // 実行関数
  public static void main(String[] args) {
    // jsonタイプのstring値
    String test = "{\"data\":1}";
    // Gsonインスタンス生成
    Gson gson = new Gson();
    // stringをNodeインスタンスに変換
    Node node = gson.fromJson(test, Node.class);
    // コンソール出力
    System.out.println(node.getData());
  }
}
// テストクラス
class Node {
  // メンバー変数
  private int data;
  // 取得関数
  public int getData() {
    return data;
  }
  // メンバー変数設定関数
  public void setData(int data) {
    this.data = data;
  }
}

結果は「json」タイプで「String」を「Node」クラスで変換をしました。その意味は「Gson」ライブラリがちゃんと動いてる状況ですね。「eclipse」から「maven」を通ってライブラリをちゃんとアップデータしてソース上で使えることを確認できます。

ここまでJavaのオープンライブラリを参照する方法(eclipseからmavenを連結)に関する説明でした。

ご不明なところや間違いところがあればコメントしてください。