Jetty の接続プールから CircleCI のデータ に接続

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CircleCI JDBC Driver は接続プールをサポートしています。この記事では、Jetty の Web アプリから CircleCI のデータ に高速に接続する方法を説明します。



CData JDBC Driver for CircleCI は、Java Web アプリケーションへの統合が簡単です。この記事では、接続プールを設定することで Jetty から CircleCI のデータ に効率的に接続する方法を説明します。Jetty で CircleCI 用の JNDI リソースを設定していきましょう。

Salesforce 用の JDBC Driver を JNDI データソースとして設定

以下のステップで Jetty から Salesforce に接続します。

  1. Jetty ベースで JNDI モジュールを有効にします。次のコマンドは、コマンドラインから JNDI を有効にします。

    java -jar ../start.jar --add-to-startd=jndi
    
  2. インストールディレクトリの lib サブフォルダにある CData およびライセンスファイルを、コンテキストパスの lib サブフォルダに追加します。
  3. リソースとそのスコープを宣言します。リソース宣言に必要な接続プロパティを入力します。次の例では、WEB-INF\jetty-env.xml に Web アプリレベルで CircleCI データソースを宣言しています。

    
    <Configure id='circlecidemo' class="org.eclipse.jetty.webapp.WebAppContext">
        <New id="circlecidemo" class="org.eclipse.jetty.plus.jndi.Resource">
        <Arg><Ref refid="circlecidemo"/></Arg>
        <Arg>jdbc/circlecidb</Arg>
        <Arg>
          <New class="cdata.jdbc.api.APIDriver">
            <Set name="url">jdbc:api:</Set>
            <Set name="Profile">C:\profiles\CircleCI.apip</Set>
            <Set name="AuthScheme">APIKey</Set>
            <Set name="ProfileSettings">'APIKey</Set>
          </New>
        </Arg>
      </New>
    </Configure>
    

    API キー認証の設定

    CircleCI は、API リクエストの認証にパーソナル API トークンを使用します。パーソナル API トークンを生成するには、CircleCI アカウントにログインし、User Settings > Personal API Tokens に移動して、Create New Token をクリックします。トークンの値は一度しか表示されないため、すぐにコピーしてください。

    以下の接続プロパティを設定して接続を確立してください:

    • AuthScheme:APIKey に設定します。
    • APIKey:CircleCI のパーソナル API トークンに設定します。

    接続文字列の例:

    Profile=C:\profiles\CircleCI.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_personal_api_token';
    
  4. Web.xml でリソースを設定します。

    
      jdbc/circlecidb
      javax.sql.DataSource
      Container
    
    
  5. これで、java:comp/env/jdbc/circlecidb をルックアップして CircleCI にアクセスできます。

    InitialContext ctx = new InitialContext();
    DataSource mycircleci = (DataSource)ctx.lookup("java:comp/env/jdbc/circlecidb");
    

Jetty 統合の詳細

上記のステップでは、シンプルな接続プールのシナリオでドライバーを設定する方法を説明しました。その他のユースケースや詳細については、Jetty ドキュメントのWorking with Jetty JNDI の章を参照してください。

はじめる準備はできましたか?

API Driver で CircleCI のライブデータに接続

CircleCI に接続