この章では、Oracle Web Services Manager(Oracle WSM)Step Software Development Kit(SDK)に関するリファレンス情報を示します。Oracle WSM Step SDKには、次のインタフェースとクラスが含まれています。
インタフェースIStep
既知の実装クラス
AbstractStep
宣言
public interface IStep
説明
ステップとは、パイプラインの基本実行ブロックです。ステップは、Java Beanのフレームワークを使用して構成されるJava Beansです。AbstractStep
クラスは、このインタフェースの部分的な実装を提供する抽象クラスです。ステップでは、リソース・プーリング方式を使用して複数のリクエストを効率的に処理できますが、起動ごとの状態を保持できません。
表3-1 IStepのメソッド
メソッド | 説明 |
---|---|
|
このステップを有効または無効にします。 |
|
ブール値をsetEnabledから取得します。 |
|
このステップの名前を設定します。 |
|
ステップ名を取得します。 |
|
ポリシー実行ポイントのコンテキスト情報を取得します。 |
|
エージェント・コンテキストを設定します。 |
|
このステップを実行します。 |
|
このメソッドは、Java Beanが作成された後またはJava Beanのプロパティが変更された後にコールされます。 |
|
ステップのライフサイクルを確実にクリーンな状態で終了できます。 |
|
このステップによってスローされるフォルト・コードを取得します。 |
|
このステップによってスローされるフォルト・コードを設定します。 |
宣言
public void setEnabled(boolean enabled)
説明
このステップを有効または無効にします。
パラメータ
Enabled
: trueの場合、ステップは有効です。
宣言
public boolean getEnabled()
説明
ブール値をsetEnabled
から取得します。
リターン
trueまたはfalseのいずれかのブール値。ステップが有効な場合はtrueの値を返します。
宣言
public void setStepName(java.lang.String stepName)
説明
このステップの名前を設定します。
パラメータ
stepName
: ステップの名前
宣言
public void setAgentContext(AgentContext context)
説明
エージェント・コンテキストを設定します。
パラメータ
context
(AgentContext
型): パイプラインの実行時のエージェントの情報を表します。
宣言
public IResult execute(IMessageContext context) Throws Fault
説明
このステップを実行します。
パラメータ
context
: リクエストおよびレスポンスを含むメッセージ・コンテキスト
リターン
IResult
: このメソッドの実行が成功した場合
Fault
: スローされる場合は、Fault型の例外
宣言
public void init() throws java.lang.IllegalStateException
説明
このメソッドは、Java Beanが作成された後またはJava Beanのプロパティが変更された後にコールされます。
スロー
java.lang.IllegalStateException
宣言
public void destroy() throws java.lang.IllegalStateException
説明
destroy
メソッドを使用すると、ステップのライフサイクルを確実にクリーンな状態で終了できます。
com.cfluent.policysteps.sdk.AbstractStep
宣言
public abstract class AbstractStep
拡張
java.lang.Object
実装
IStep
説明
IStep
のデフォルトの実装。実装では、少なくともIStep
のexecute
メソッドをオーバーライドする必要があります。
表3-2 AbstractStepのメソッド
メソッド | 説明 |
---|---|
|
Java Beanが作成された後またはJava Beanのプロパティが変更された後にコールされます。 |
|
trueの場合、ステップは有効です。 |
|
setEnabledの値を返します。ステップが有効な場合はtrue、それ以外の場合はfalseです。 |
|
このステップの名前を設定します。 |
|
ステップ名を取得します。 |
|
インタフェース |
|
エージェント・コンテキストを設定します。 |
|
このステップに対する |
|
|
|
このステップによってスローされるフォルト・コードを取得します。 |
|
このステップによってスローされるフォルト・コードを設定します。 |
|
ステップのライフサイクルを確実にクリーンな状態で終了できます。 |
|
このステップに対するフォルトを生成します。 |
|
このステップに対する結果を作成します。 |
宣言
protected IResult createResult(int status)
パラメータ
int
status
説明
このメソッドは、Java Beanが作成された後またはJava Beanのプロパティが変更された後にコールされます。
宣言
public final void setEnabled(boolean enabled)
説明
このステップを有効または無効にします。
パラメータ
boolean enabled
指定元
インタフェースIStepのsetEnabled
パラメータ
enabled
: trueの場合、ステップは有効です。
宣言
public final boolean getEnabled()
説明
ステップが有効かどうかをチェックします。
指定元
インタフェースIStepのgetEnabled
リターン
trueまたはfalseのいずれかのブール値。ステップが有効な場合はtrueの値を返します。
宣言
public final void setStepName(java.lang.String stepName)
説明
このステップの名前を設定します。
指定元
インタフェースIStepのsetStepName
パラメータ
stepName
: ステップの名前
宣言
public final java.lang.String getStepName()
説明
ステップ名を取得します。
指定元
インタフェースIStep
のgetStepName
リターン
このステップの名前。
宣言
public final AgentContext getAgentContext()
説明
ステップのエージェント・コンテキストを取得します。
パラメータ
context
指定元
インタフェースIStep
のgetAgentContext
。
宣言
public final void setAgentContext(AgentContext context)
説明
エージェント・コンテキストを設定します。
指定元
インタフェースIStep
のsetAgentContext
宣言
public abstract IResult execute(IMessageContext messageContext)
説明
ステップを実行します。ステップの実装では、このメソッドをオーバーライドして目的のタスクを実行します。
指定元
インタフェースIStep
のexecute
パラメータ
messageContext
: リクエストおよびレスポンスを含むメッセージ・コンテキスト
リターン
実行結果により、IResult
またはFault
を返します。
宣言
public void init()
説明
java.lang.IllegalStateException
をスローします。このメソッドは、Java Beanが作成された後またはJava Beanのプロパティが変更された後にコールされます。
指定元
インタフェースIStep
のinit
スロー
java.lang.IllegalStateException
宣言
public void destroy() throws java.lang.IllegalStateException
説明
destroy
メソッドを使用すると、ステップのライフサイクルを確実にクリーンな状態で終了できます。
指定元
インタフェースIStep
のdestroy
宣言
void setFaultCodes(String[] faultCodes)
説明
このステップによってスローされるフォルト・コードを設定します。
指定元
インタフェースIStep
のinit
パラメータ
faultCodes
(String[]
型): ステップによってスローされるフォルト・コード
インタフェース
IContext
サブインタフェース
IMessageContext
宣言
public interface IContext
説明
コンポーネントに関するパイプライン実行コンテキストについての情報
表3-4 IContext()のメソッド
メソッド | 説明 |
---|---|
|
特定のプロパティを検索し、プロパティの値を返します( |
|
すべてのプロパティ名についてイテレータを返します。 |
|
指定されたプロパティ( |
|
指定されたプロパティ( |
|
指定されたプロパティ( |
宣言
public java.lang.Object getProperty(java.lang.String propName)
説明
特定のプロパティを検索し、そのプロパティの値を返します。
リターン
propName
の値
宣言
public boolean containsProperty(java.lang.String propName)
説明
特定のプロパティの有無をチェックします。
リターン
trueまたはfalseのいずれかのブール値。
インタフェースIMessageContext
宣言
public interface IMessageContext extends IContext
説明
ステップで処理されるメッセージについてのコンテキスト情報を提供します。
すべてのスーパーインタフェース
IContext
インタフェースcom.cfluent.policysteps.sdk.IContextからの継承
containsProperty
、getProperty
、getPropertyNames
、removeProperty
、setProperty
、setProperty
表3-5 IMessageContext()のstaticフィールド
フィールド | 説明 |
---|---|
STAGE_PREREQUEST |
リクエスト前処理ステージを示します。 |
STAGE_REQUEST |
リクエスト処理ステージを示します。 |
STAGE_RESPONSE |
レスポンス処理ステージを示します。 |
STAGE_POSTRESPONSE |
レスポンス後処理ステージを示します。 |
STAGE_SERVICE |
メッセージがサービス・ステージにあることを示します。 |
STAGE_SERVICE_DEFINITION |
Webサービスの定義を指定します。 |
STAGE_SERVICE_WSDL |
WebサービスのWSDLを指定します。 |
表3-6 IMessageContext()のメソッド
メソッド | 説明 |
---|---|
|
グローバルな一意のIDを取得します。 |
|
サービスIDを取得します。 |
|
サービスURLを取得します。 |
|
リモート・ユーザーを取得します。 |
|
SOAPリクエストを取得します。 |
|
SOAPレスポンスを取得します。 |
|
リクエスト・メッセージを設定します。 |
|
レスポンス・メッセージを設定します。 |
|
処理ステージ情報を取得します。 |
|
処理ステージを設定します。 |
|
起動ステータスを取得します。 |
|
ユーザーのロケールを設定します。プロトコル・ハンドラは、このメソッドを使用してメッセージ・プロパティおよびメッセージ・ヘッダーでロケール情報を探します。ロケール情報が見つかった場合は、そのロケールが設定されます。ロケール情報が見つからなかった場合、ユーザーのロケールは製品のロケールにデフォルトで設定されます。 |
|
ユーザーのロケールを取得します。ポリシー・ステップの実装コードでは、ユーザーのロケールを使用してSOAPフォルトをユーザー指定のロケールで提供します。 |
宣言
public java.lang.String getServiceID()
説明
サービスIDを取得します。
リターン
Oracle WSMのサービス登録情報に基づいたサービスID
宣言
public java.lang.String getRemoteUser()
説明
サービス・リクエスタのIDを取得します。
リターン
リモート・ユーザーを取得します。
宣言
public com.cfluent.ccore.message.SOAPMessage getRequestMessage()
説明
SOAPリクエストを取得します。
リターン
SOAPリクエスト・メッセージ
宣言
public com.cfluent.ccore.message.SOAPMessage getResponseMessage()
説明
SOAPレスポンスを取得します。
リターン
SOAPレスポンス・メッセージ
宣言
public void setRequestMessage(com.cfluent.ccore.message.SOAPMessage requestMessage)
説明
リクエスト・メッセージを設定します。
宣言
public void setResponseMessage(com.cfluent.ccore.message.SOAPMessage responseMessage)
説明
レスポンス・メッセージを設定します。
宣言
public class IResult()
拡張
java.lang.Object
クラスjava.lang.Objectから継承されるメソッド
clone
、equals
、finalize
、getClass
、hashCode
、notify
、notifyAll
コンストラクタ
public Result()
表3-7 IResultのメソッド
メソッド | 説明 |
---|---|
|
実行ステータスを取得します。 |
|
実行ステータスを設定します。 |
|
リクエストの実行が失敗した原因となるフォルトを返します。 |
|
このリクエストの実行が失敗した原因となるフォルトを設定します。このフォルトは、適用可能なすべてのフォルト・ハンドラが失敗した場合にフレームワークによって設定されます。ステップの実装では、 |
宣言
public void setStatus(int status)
説明
実行ステータスを設定します。
指定元
インタフェースIResult
のsetStatus
パラメータ
status
: 実行ステータスを設定します。
宣言
public class Result()
拡張
java.lang.Object
実装
IResult
クラスjava.lang.Objectから継承されるメソッド
clone
、equals
、finalize
、getClass
、hashCode
、notify
、notifyAll
コンストラクタ
public Result()
インタフェースcom.cfluent.policysteps.sdk.IResultから継承されるフィールド
FAILED、SUCCEEDED、SUSPENDED
表3-8 Resultのメソッド
メソッド | 説明 |
---|---|
|
実行ステータスを取得します。 |
|
実行ステータスを設定します。 |
|
リクエストの実行が失敗した原因となるフォルトを返します。 |
|
このリクエストの実行が失敗した原因となるフォルトを設定します。このフォルトは、適用可能なすべてのフォルト・ハンドラが失敗した場合にフレームワークによって設定されます。ステップの実装では、generateFaultメソッドのみをコールする必要があります。 |
|
String形式の結果。 |
宣言
public void setStatus(int status)
説明
実行ステータスを設定します。
指定元
インタフェースIResult
のsetStatus
パラメータ
status
: 実行ステータスを設定します。
宣言
public Fault getFault()
説明
リクエストの実行が失敗した原因となるフォルトです。このフォルトは、適用可能なすべてのフォルト・ハンドラが失敗した場合にフレームワークによって設定されます。
指定元
インタフェースIResult
のgetFault
リターン
リクエスト失敗の原因となったフォルトです。
宣言
public class AgentContext
拡張
java.lang.Object
プロパティ
agentID
、resolver
、properties
説明
エージェントのコンテキスト情報を取得して使用するメソッドを提供します。
コンストラクタ
public AgentContext
(java.lang.String agentId
,
com.cfluent.common.resource.IResourceResolver resolver
,
java.util.Map
properties)
throws java.io.IOException
表3-9 AgentContextのstaticフィールド
フィールド | 説明 |
---|---|
SERVER_ID |
コンポーネントID。 |
LOG_LOGBUNDLES |
ログのバンドル。 |
LOG_LOGENABLED |
ロギングが有効であるかどうかを指定します。 |
COREMAN_ENABLED |
Oracle WSM Monitorが有効であるかどうかを指定します。 |
POLICYSERVER_ENDPOINT |
Oracle WSM Policy Managerのエンドポイントを指定します。 |
POLICYSERVER_ENABLED |
Oracle WSM Policy Managerが有効であることを指定します。 |
POLICYPACKS_FILENAME |
ポリシー・パックのファイル名(内部プロパティ)。 |
表3-10 AgentContextのメソッド
メソッド | 説明 |
---|---|
|
エージェントID(string)を取得します。 |
|
指定されたpropNameのプロパティ値を取得します。 |
|
指定されたプロパティの値を取得します。プロパティが存在しない場合はNULLを返します。 |
|
プロパティをinteger(プリミティブ)として取得します。 |
|
リソースに対するリゾルバを取得します。リゾルバは、リソースへの絶対パスを取得するために使用されます。 |
|
すべてのプロパティをキー/値のペアとして取得します。 |
宣言
public static final java.lang.String COREMAN_ENABLED
説明
Oracle WSM Monitorが有効であることを指定するプロパティ。
宣言
public static final java.lang.String POLICYSERVER_ENDPOINT
説明
Oracle WSM Policy Managerのエンドポイントのプロパティ。
宣言
public java.lang.String getAgentID()
説明
エージェントIDを取得します。エージェントIDは、config.xml
ファイルに構成され、初期化時にコンストラクタによってプロパティとしてロードされます。
リターン
エージェントID(string)。
宣言
public java.lang.Object getProperty(java.lang.String propName)
説明
指定されたpropName
のプロパティ値を取得します。
パラメータ
propName
: 値を取得する必要があるプロパティの名前
リターン
指定されたプロパティの値。プロパティが存在しない場合はNULLを返します。
宣言
public java.lang.String getStringProperty(java.lang.String propName, java.lang.String defaultValue)
説明
プロパティ値をstringとして取得します。
パラメータ
propName
: 値を取得する必要があるプロパティの名前
リターン
引数に指定されたプロパティの値のstring表現。プロパティが使用できない場合はNULLを返します。
宣言
public int getIntProperty(java.lang.String propName)
説明
プロパティをinteger(プリミティブ)として取得します。
パラメータ
propName
: 値を取得する必要があるプロパティの名前
リターン
引数に指定されたプロパティ名のinteger(プリミティブ)値
宣言
public int getIntProperty(java.lang.String propName, java.lang.string defaultValue)
説明
引数に指定されたプロパティの値をフェッチします。
パラメータ
propName
: 値を取得する必要があるプロパティの名前
defaultValue
: プロパティを取得できない場合に返されるデフォルト値
リターン
引数に指定されたプロパティの値。プロパティが存在する場合は値が返されます。プロパティが使用できない場合は、引数に指定されたデフォルト値が返されます。
宣言
public class InvocationStatus
拡張
java.lang.Object
実装
java.io.Serializable
クラスjava.lang.Objectからの継承
clone
、equals
、finalize
、getClass
、hashCode
、notify
、notifyAll
説明
このクラスは、ステップの実行ステータスをOracle WSM Monitorに送信します。Oracle WSM Monitorでは、この情報を使用して測定を解析します。
コンストラクタ
public InvocationStatus()
表3-11 InvocationStatusのフィールド
フィールド | 説明 |
---|---|
SUCCEEDED |
起動成功フラグ |
FAILED |
起動失敗フラグ |
FAILEDOVER |
フェイルオーバー済フラグ |
PENDING |
測定保留または実行保留 |
NA |
オブジェクト使用不可 |
表3-12 InvocationStatusのメソッド
メソッド | 説明 |
---|---|
|
起動されるサービスの名前を取得します。 |
|
サービスの名前を設定します。 |
|
時刻を取得します。 |
|
時刻を設定します。 |
|
認証ステータスを取得します。 |
|
認証ステータスを設定します。 |
|
認可ステータスを取得します。 |
|
認可ステータスを設定します。 |
|
サービスのステータスを取得します。 |
|
サービスのステータスを設定します。 |
|
起動ステータスを取得します。 |
|
起動ステータスを設定します。 |
|
サイズを取得します。 |
|
サイズを設定します。 |
|
ポリシー・パイプラインの全体待機時間のデフォルト値を取得します。 |
|
全体待機時間の値を設定します。 |
|
サービス待機時間の値(ミリ秒)を取得します。 |
|
サービス待機時間の値(ミリ秒)を設定します。 |
|
フローIDを取得します。 |
|
フローIDを設定します。 |
|
メソッドを取得します。 |
|
メソッドを設定します。 |
|
相関を取得します。 |
|
相関を設定します。 |
getMessageId() |
メッセージIDを取得します。 |
|
メッセージIDを設定します。 |
|
失敗のエラー・メッセージを取得します。 |
|
失敗のエラー・メッセージを設定します。 |
|
オブジェクトのString表現。 |
宣言
public java.lang.String getServiceName()
説明
起動されるサービスの名前を取得します。
リターン
起動されるサービスの名前
宣言
public void setAuthenticationStatus(int s)
説明
認証ステータスを設定します。
パラメータ
s
: 認可ステータスの値
宣言
public void setAuthorizationStatus(int s)
説明
認可ステータスを設定します。
パラメータ
s
: 認可ステータスの値
宣言
public void setInvocationStatus(int s)
説明
起動ステータスを設定します。
パラメータ
s
: 起動ステータスの値
宣言
public int getServiceLatency()
説明
サービスのみの待機時間を取得します。
リターン
サービス待機時間の値(ミリ秒)
関連項目
getLatency()
宣言
public void setFlowID(java.lang.String flowid)
説明
フローIDを設定します。
パラメータ
flowid
: フローIDを表す文字列
宣言
public void setMethod(java.lang.String inMethod)
説明
メソッドを設定します。
パラメータ
inMethod
: WSDLの操作
宣言
public void setCorrelationContext(java.lang.String inCorrelationContext)
説明
相関を設定します。
パラメータ
inCorrelationContext
: 相関コンテキスト文字列
宣言
public void setMessageId(java.lang.String inMessageId)
説明
メッセージIDを設定します。
パラメータ
inMessageId
: メッセージID文字列
宣言
public class Fault extends BaseException
説明
Fault
クラスには、ステップ実行失敗に関するすべての情報が含まれます。
表3-13 Faultのメソッド
メソッド | 説明 |
---|---|
|
フォルト・ネームスペースを取得します。 |
|
フォルト文字列を取得します。 |
|
フォルトの詳細を取得します。 |
|
フォルト・アクターを取得します。 |
|
修飾されたフォルト・コード(たとえば、Client.AuthenticationFailure)を取得します。 |
|
フォルト・コードの修飾子を取得します。 |
|
フォルト・コードを取得します。 |
|
フォルトの詳細をstringとして取得します。 |