20 カスタム・アクセス設定API

この章では、カスタム・アクセス設定APIのユースケースについて説明します。また、カスタム・アクセス設定タイプ・リストの取得、およびOracle Enterprise Repository内にある特定のタイプのデフォルトのカスタム・アクセス設定リストの取得を行う方法について解説します。

この章では、次の項目について説明します。

• 20.1項「概要」

• 20.2項「ユースケース」

20.1 概要

カスタム・アクセス設定サブシステムは、Oracle Enterprise Repositoryのカスタム・アクセス設定(CAS)を取得する、Webサービス・ベースのメカニズムを提供するために使用します。例20-1に、カスタム・アクセス設定のサンプル・コードを示します。

例20-1 カスタム・アクセス設定のサンプル・コード

カスタム・アクセス設定を行うオープンAPIメソッドの作業コードです。

package com.flashline.sample.customaccesssettingsapi;
import java.net.MalformedURLException;
import java.net.URL;
import java.rmi.RemoteException;
import javax.xml.rpc.ServiceException;
import com.flashline.registry.openapi.base.OpenAPIException;
import com.flashline.registry.openapi.entity.AuthToken;
import com.flashline.registry.openapi.service.v300.FlashlineRegistry;
import
 com.flashline.registry.openapi.service.v300.FlashlineRegistryServiceLocator;
public class CustomAccesssettings {
  public static void main(String pArgs[]) throws java.rmi.RemoteException,
      OpenAPIException {
    try {
      ///////////////////////////////////////////////////////////
      // Connect to Oracle Enterprise Repository
      ///////////////////////////////////////////////////////////
      URL lURL = null;
      lURL = new URL(pArgs[0]);
      FlashlineRegistry repository = new FlashlineRegistryServiceLocator()
          .getFlashlineRegistry(lURL);
      // //////////////////////////////
      // Authenticate with OER
      // //////////////////////////////
      AuthToken authToken = repository.authTokenCreate(
          pArgs[1],pArgs[2]);
      // ////////////////////////////////////////////////////////////
      // Retrieve a List of Custom Access Setting Types
      // ////////////////////////////////////////////////////////////
      String[] lRoleContextTypes = null;
      lRoleContextTypes = repository
          .customAccessSettingTypesGet(authToken);
      // ////////////////////////////////////////////////////////////
      // Get Custom Access Setting Names
      // ////////////////////////////////////////////////////////////
      String[] lCustomAccessSettingNames = null;
      lCustomAccessSettingNames = repository
          .customAccessSettingNamesGet(authToken, "asset");
      // ////////////////////////////////////////////////////////////
      // Retrieve an array of Custom Access Setting Names of type "asset".
      // ////////////////////////////////////////////////////////////
      String[] rCustomAccessSettingNames = null;
      rCustomAccessSettingNames = repository
          .customAccessSettingDefaultNamesGet(authToken, "asset");
    } catch (OpenAPIException lEx) {
      System.out.println("ServerCode = " + lEx.getServerErrorCode());
      System.out.println("Message    = " + lEx.getMessage());
      System.out.println("StackTrace:");
      lEx.printStackTrace();
    } catch (RemoteException lEx) {
      lEx.printStackTrace();
    } catch (ServiceException lEx) {
      lEx.printStackTrace();
    } catch (MalformedURLException lEx) {
      lEx.printStackTrace();
    }
  }
}

20.2 ユースケース

この項では、カスタム・アクセス設定APIを使用するユースケースについて説明します。含まれる内容は、次のとおりです。

• 20.2.1項「ユースケース: カスタム・アクセス設定タイプ・リストの取得」

• 20.2.2項「ユースケース: デフォルトのカスタム・アクセス設定名の取得」

20.2.1 ユースケース: カスタム・アクセス設定タイプ・リストの取得

説明

このメソッドは、Oracle Enterprise Repositoryで使用可能なカスタム・アクセス設定タイプ・リストを取得するために使用します。

サンプル・コード

1. String[] lCustomAccessSettingNames = null;
2. lCustomAccessSettingNames = mFlashlineRegistry.customAccessSettingNamesGet
    (mAuthToken, "asset");

注釈

行2: タイプ"asset"のカスタム・アクセス設定名の配列を取得します。

20.2.2 ユースケース: デフォルトのカスタム・アクセス設定名の取得

説明

このメソッドは、特定のタイプのデフォルトのカスタム・アクセス設定リストを取得するために使用します。ファイルのデフォルトのカスタム・アクセス設定がすべての新しいファイルに適用されるように、アセットのデフォルトのカスタム・アクセス設定がすべての新しいアセットに適用されます。

サンプル・コード

1. String[] lCustomAccessSettingNames = null;
2. lCustomAccessSettingNames = mFlashlineRegistry.customAccessSettingDefault
     NamesGet(mAuthToken, "asset");

注釈

行2: タイプ"asset"のデフォルトのカスタム・アクセス設定名の配列を取得します。