Perl クライアント・クラス・リファレンス

$conn = Intersys::PERLBIND::Connection->new($url, $user, $pwd, $timeout) 

パラメータの詳細は、この後の "接続情報" を参照してください。

$conn = Intersys::PERLBIND::Connection->new_secure($url, $srv_principal,
    $security_level, $timeout)

Connection->new_secure() は接続プロキシを返します。このプロキシを使用して、$url で識別される Caché ネームスペースのプロキシを取得します。このメソッドには以下のパラメータを指定します。

• $url — URL 形式の詳細は、後述の "接続情報" を参照してください。

• $srv_principal — Kerberos の "プリンシパル" は Kerberos データベースで使用される ID であり、Kerberos KDC (鍵配布センター) とのみ共有される永続秘密鍵を所有します。さらに、資格情報が割り当てられ、Kerberos 認証プロトコルに関与することができます。

  • "ユーザ・プリンシパル" はユーザに関連付けられ、サービスに対する認証に使用することで、リソース (コンピュータ・アカウントや Caché サービスなど) の使用が承認されます。

  • "サービス・プリンシパル" はサービスに関連付けられ、ユーザ・プリンシパルを認証するために使用されます。また必要に応じ、ユーザ・プリンシパルに対してサービス・プリンシパル自体を認証することもできます。

  • "サービス・プリンシパル名" ($srv_principal_name など) は、サービス・プリンシパルの名前の文字列表現で、慣習的に以下の形式が使用されています。

    <service>/<instance>@<REALM>

    以下はその例です。

    cache/turbo.iscinternal.com@ISCINTERNAL.COM

  Windows の場合、KDC はドメイン・コントローラに組み込まれ、サービス・プリンシパル名はドメイン・アカウントに関連付けられます。

  プリンシパルの詳細は、お使いのシステムの Kerberos ドキュメントを参照してください。

• $security_level — "接続のセキュリティ・レベル" を設定します。これは、要求されたクライアント/サーバ・ネットワーク・セキュリティ・サービスを示す整数です。セキュリティ・レベルには以下の値を指定できます。

  • 0 — なし。

  • 1 — Kerberos クライアント/サーバ相互認証。データは保護されません。

  • 2 — 1 と同じ。さらに、データ・ソースとコンテンツの整合性が保護されます。

  • 3 — 2 と同じ。さらに、データが暗号化されます。

• $timeout — タイムアウトになるまで待機する秒数。

$query = $database->alloc_query()

新しい Query オブジェクトを作成します。Query オブジェクト・メソッドの詳細は、"クエリ" を参照してください。

$obj = $database->create_new($type, $init_val) 

$type によって指定されたクラスから、新しい Caché オブジェクト・インスタンスを作成します。通常、$init_val は "" です。このメソッドで作成されたオブジェクトの詳細は、"オブジェクト" を参照してください。

$database = Intersys::PERLBIND::Database->new($conn)

Caché ネームスペースへの論理接続を可能にする Database オブジェクトを生成します。Connection オブジェクト $conn は、Database オブジェクトがアクセスするネームスペースへの物理接続を提供します。

$obj = $database->open($class_name, $oid, $concurrency, $timeout, $res) 

$class_name で指定されたクラスとオブジェクトの OID を使用して、Caché オブジェクトのインスタンスを開きます。$concurrency 引数には -1 の既定値があります。$timeout は ODBC クエリのタイムアウトです。

$obj = $database->openid($class_name, $id, $concurrency, $timeout) 

$class_name で指定されたクラスとオブジェクトの ID を使用して、Caché オブジェクトのインスタンスを開きます。$concurrency 引数には -1 の既定値があります。$timeout は ODBC クエリのタイムアウトです。

$value = $database->run_class_method($class_name, $method_name, LIST) 

クラス・メソッド $method_name を実行します。$method_name は、$database の接続先となるネームスペースにある $class_name クラスのメンバです。引数は LIST として渡されます。Caché のクラス定義によっては、一部の引数を参照で渡すこともできます。返り値は、Caché メソッドの返り値と同じです。

$value = $object->get($prop_name)

Caché オブジェクト $object のプロパティ $prop_name の値を返します。

@methodlist = $object->get_methods(); 
$methodcount = $object->get_methods(); 

リスト・コンテキストでは、Caché オブジェクト $object のメソッド名を含むリストを返します。スカラ・コンテキストでは、$object のメソッド数を返します。

@proplist = $object->get_properties(); 
$propcount = $object->get_properties();

リスト・コンテキストでは、Caché オブジェクト $object のプロパティ名を含むリストを返します。スカラ・コンテキストでは、$object のプロパティ数を返します。プライベート・プロパティと多次元プロパティは返されず、Perl バインディングからはアクセスできません。

$bool = $object->is_method($name);

$name が $object の有効なメソッド名の場合は 1 を、それ以外の場合は 0 を返します。

$bool = $object->is_property($name);

$name が $object の有効なプロパティ名の場合は 1 を、それ以外の場合は 0 を返します。

$value = $object->run_obj_method($method_name, LIST) 

Caché オブジェクト $object のメソッド $method_name を実行します。引数は LIST として渡されます。Caché のクラス定義によっては、一部の引数を参照で渡すこともできます。返り値は、Caché メソッドの返り値と同じです。

$object->set($prop_name, $val)

Caché オブジェクト $object のプロパティ $prop_name を $val に設定します。

$clientver = Intersys::PERLBIND::get_client_version();

Perl クライアント・マシン上で実行されている Caché のバージョンを確認します。

$newlocale = Intersys::PERLBIND::setlocale($category, $locale)

既定のロケールを設定し、新しいロケールのロケール文字列を返します。以下はその例です。

   $newlocale = Intersys::PERLBIND::setlocale(0, "Russian") # 0 stands for LC_ALL

これは、すべてのロケール・カテゴリを Russian に設定し、以下の文字列を返します。

   Russian_Russia.1251

$locale 引数が空文字列の場合は、現在の既定のロケール文字列が返されます。例えば、以下のコードを指定したとします。

   Intersys::PERLBIND::setlocale(0, "English")
   $mylocale = Intersys::PERLBIND::setlocale(0, ""),"\n";

$mylocale の値は、以下のようになります。

   English_United States.1252

有効な $category 値を含む使用法の詳細は、MSDN ライブラリ (http://www.microsoft.com/japan/msdn/library)Opens in a new tab で、Visual C++ ランタイム・ライブラリの setlocale() 関数の説明を参照してください。

Intersys::PERLBIND::set_thread_locale($lcid)

呼び出しスレッドのロケール ID (LCID) を設定します。実行時にロケールとの連係を必要とするアプリケーションは、このメソッドを呼び出して正しい変換を行う必要があります。これは現在のスレッド内で C++ ランタイム・ライブラリから setlocale() を呼び出すのと同じですが、setlocale() を直接呼び出すと、場合によっては例外がスローされることなく失敗することがあります。

有効な LCID 値については、MSDN ライブラリ (http://www.microsoft.com/japan/msdn/libraryOpens in a new tab) にある "ロケール ID (LCID) の一覧" を参照してください。"LCID 一覧" で検索すると、この一覧が表示されます。現在の場所は以下のとおりです。

http://www.microsoft.com/japan/msdn/library/default.asp?url=/japan/msdn/library/ja/script56/html/vsmsclcid.aspOpens in a new tab

ロケール設定の詳細は、MSDN ライブラリで、"National Language Support" の SetThreadLocale() 関数を参照してください。