コネクターメタデータは、抽象Java class JDBCMetaDataの実装です。これは、サードパーティ製ソースへの接続を作成するために、ユーザーへどのような接続詳細を要求する必要があるのかを定義します。これには、ユーザー名、トークン、ホスト名、ポート番号、アカウント名、などのパラメーターが含まれます。
JDBCMetaDataでは、以下のヘルパー関数にアクセスすることもできます。
constructorには、以下の属性を設定する必要があります。
属性 | 説明 |
sourceName | データソースのテキスト名です。例:Twitter Connector |
sourceCode | データソースに一意のテキストコードです。例:TWITTER_CONNECTOR |
driverName | データソースのテキストclass名です。例:com.code.TwitterConnector |
sourceType | こちらは常に、「DBType.THIRDPARTY」と記述します。 |
実装例
public SkiTeamMetaData() { super(); sourceName = "Ski Team Source"; sourceCode = "SKI_DATA_SOURCE"; driverName = SkiTeamDataSource.class.getName(); sourceType = DBType.THIRD_PARTY; } |
実装例
public void initialiseParameters() { super.initialiseParameters(); addParameter(new Parameter("HELP", "Connection Details", "Text", TYPE_NUMERIC, DISPLAY_STATIC_TEXT, null, true)); Parameter p = new Parameter("URL", "1. Request Access PIN", "Connect to twitter to receive a PIN for data access",TYPE_UNKNOWN, DISPLAY_URLBUTTON, null, true); p.addOption("BUTTONTEXT", "Request URL"); p.addOption("BUTTONURL", "http://google.com"); addParameter(p); addParameter(new Parameter("PIN", "2. Enter PIN", "Enter the PIN recieved from Twitter", TYPE_NUMERIC, DISPLAY_TEXT_MED, null, true)); p = new Parameter("POSTPIN", "3. Validate Pin", "Validate the PIN", TYPE_TEXT, DISPLAY_BUTTON, null, true); p.addOption("BUTTONTEXT", "Validate PIN"); addParameter(p); addParameter(new Parameter("ACCESSTOKEN", "Access Token", "AccessToken that allows access to the Twitter API", TYPE_TEXT, DISPLAY_PASSWORD, null, true)); addParameter(new Parameter("ACCESSTOKENSECRET", "Access Token Secret", "AccessToken Password that allows access to the Twitter API", TYPE_TEXT, DISPLAY_PASSWORD, null, true)); } |
属性 | 説明 |
uniqueKey | このパラメーターのテキストユニークキーです。 |
displayName | テキストの説明です。これは、国際化することができます。 |
description | パラメーターの説明です。これは、国際化することができます。 |
defaultValue | このパラメータのデフォルト値として割り当てられるオブジェクトです。 |
displayType | このパラメーターの表示型です。 より詳細な情報は、付録内のDisplayTypeを参照してください。 |
dataType | このパラメーターのデータ型です。 より詳細な情報は、付録内のパラメーターDataTypeを参照してください。 |
Classパラメーターには複数のconstructorがあり、このオブジェクトをJavaコードの一行で定義することができます。
パラメーター表示型の中には、ドロップダウンボックスや、ラジオボタンのように、追加のオプションを必要とするものもあります。これらは、インスタンス化後に、パラメーターオブジェクトへ追加されなくてはいけません。
例:
Parameter p = new Parameter("URL", " Access PIN", "Connect to twitter to receive a PIN for data access",TYPE_UNKNOWN, DISPLAY_URLBUTTON, null, true); p.addOption("BUTTONTEXT", "Request URL"); p.addOption("BUTTONURL", "http://google.com"); addParameter(p); |
ボタンコールバックは、プログラムに従い、他のパラメーターの値の変更に使用されます。パラメーターは、setParameterValue(String key, String value)とともに設定されます。
例:
public boolean isParameterRequired(String key) { if ("DOMAIN".equals(key)) { if ("SQL".equals(getParameterValue("WINDOWSAUTH"))) { return false; } } return true; } |
|