GSSName (Java Platform SE 7)

```
public interface GSSName
```
このインタフェースは、単一の GSS-API 主体エンティティーをカプセル化します。アプリケーションでは、GSSManager クラスに含まれる createName メソッドのいずれかを使用してこのインタフェースの実装を取得します。GSSName は、エンティティーの複数の表現、つまり複数のプリミティブ名前要素 (サポートされている配下のメカニズムごとに 1 つずつ) で構成されます。GSS では、1 つだけのメカニズムの要素を含む GSSName をメカニズム名 (MN) と呼びます。
主体の識別に使用される名前空間は、認証メカニズムごとに異なります。このため、複数メカニズム環境では、GSS-API のネーミングサポートが複雑になります。また、単一メカニズム環境の場合でも、配下のメカニズムが複数の名前空間をサポートしているときは、同様に複雑になります。名前の形式とその定義は、Oid's によって識別されます。一部の標準型は、このインタフェースに定義されています。名前の形式は、その名前型の一意の Oid に基づいて派生させることができます。
次のコード例では、GSSName インタフェースを使用しています。まず、GSSName を作成し、それを MN に変換します。次に、名前を比較し、その名前の出力可能な表現を取得します。最後に、その名前を byte 配列にエクスポートしてから再インポートし、新しい GSSName を取得します。
```
      GSSManager manager = GSSManager.getInstance();

      // create a host based service name
      GSSName name = manager.createName("service@host",
                   GSSName.NT_HOSTBASED_SERVICE);

      Oid krb5 = new Oid("1.2.840.113554.1.2.2");

      GSSName mechName = name.canonicalize(krb5);

      // the above two steps are equivalent to the following
      GSSName mechName = manager.createName("service@host",
                      GSSName.NT_HOSTBASED_SERVICE, krb5);

      // perform name comparison
      if (name.equals(mechName))
              print("Names are equals.");

      // obtain textual representation of name and its printable
      // name type
      print(mechName.toString() +
                      mechName.getStringNameType().toString());

      // export and re-import the name
      byte [] exportName = mechName.export();

      // create a new name object from the exported buffer
      GSSName newName = manager.createName(exportName,
                      GSSName.NT_EXPORT_NAME);

 
```
導入されたバージョン:

1.4

関連項目:
export(), equals(GSSName), GSSManager.createName(String, Oid), GSSManager.createName(String, Oid, Oid), GSSManager.createName(byte[], Oid)

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static Oid`	`NT_ANONYMOUS` 匿名のエンティティーを表す名前型です。
`static Oid`	`NT_EXPORT_NAME` エクスポートされた名前を示す名前型です。export メソッドによって生成されます。
`static Oid`	`NT_HOSTBASED_SERVICE` ホストベースのサービスの名前型を示す OID です。
`static Oid`	`NT_MACHINE_UID_NAME` ローカルシステム上のユーザーに対応する数値ユーザー ID を示す名前型です (Uid など)。
`static Oid`	`NT_STRING_UID_NAME` ローカルシステム上のユーザーの数値ユーザー ID を表す、数字の文字列を示す名前型です。
`static Oid`	`NT_USER_NAME` ローカルシステム上の特定のユーザーを示す名前型です。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`GSSName`	`canonicalize(Oid mech)` 特定のメカニズムに対して標準化される名前を作成します。
`boolean`	`equals(GSSName another)` 2 つの `GSSName` オブジェクトを比較して、それらが同じエンティティーを参照しているかどうかを検査します。
`boolean`	`equals(Object another)` この `GSSName` オブジェクトを、`GSSName` である可能性がある別のオブジェクトと比較します。
`byte[]`	`export()` 標準化されたメカニズム名 (MN) を連続するバイト表現として返します。この表現は、承認機能が名前をバイト単位に直接比較するときに適しています。
`Oid`	`getStringNameType()` この名前のプリント可能な表現の名前型を返します。 `toString` メソッドからは、この名前型で返されます。
`int`	`hashCode()` この GSSName のハッシュコード値を返します。
`boolean`	`isAnonymous()` この名前オブジェクトが匿名のエンティティーを表しているかどうかテストします。
`boolean`	`isMN()` この名前オブジェクトがメカニズム名 (MN) を表しているかどうかテストします。
`String`	`toString()` `GSSName` オブジェクトのテキスト表現を返します。

- フィールドの詳細
  - NT_HOSTBASED_SERVICE
```
static final Oid NT_HOSTBASED_SERVICE
```
    ホストベースのサービスの名前型を示す OID です。この名前型は、ホストコンピュータに関連付けられたサービスを表すために使用します。この名前型は、「service」と「hostname」という 2 つの要素で作成し、service@hostname の形式になります。
    これは次の OID 値を表します。
    { iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) service_name(4) }
  - NT_USER_NAME
```
static final Oid NT_USER_NAME
```
    ローカルシステム上の特定のユーザーを示す名前型です。
    これは次の OID 値を表します。
    { iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) user_name(1) }
  - NT_MACHINE_UID_NAME
```
static final Oid NT_MACHINE_UID_NAME
```
    ローカルシステム上のユーザーに対応する数値ユーザー ID を示す名前型です (Uid など)。(Uid など)。
    これは次の OID 値を表します。
    { iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) machine_uid_name(2) }
  - NT_STRING_UID_NAME
```
static final Oid NT_STRING_UID_NAME
```
    ローカルシステム上のユーザーの数値ユーザー ID を表す、数字の文字列を示す名前型です。
    これは次の OID 値を表します。
    { iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) string_uid_name(3) }
  - NT_ANONYMOUS
```
static final Oid NT_ANONYMOUS
```
    匿名のエンティティーを表す名前型です。
    これは次の OID 値を表します。
    { 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 3(gss-anonymous-name) }
  - NT_EXPORT_NAME
```
static final Oid NT_EXPORT_NAME
```
    エクスポートされた名前を示す名前型です。export メソッドによって生成されます。
    これは次の OID 値を表します。
    { 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 4(gss-api-exported-name) }
- メソッドの詳細
  - equals
```
boolean equals(GSSName another)
               throws GSSException
```
    2 つの GSSName オブジェクトを比較して、それらが同じエンティティーを参照しているかどうかを検査します。
    
    パラメータ:
    another - この名前と比較する GSSName
    
    戻り値:
    2 つの名前に同じ基本要素が 1 つ以上含まれている場合は、true。どちらかの名前が匿名のエンティティーを表している場合は、false。
    
    例外:
    
    GSSException - 名前を比較できない場合、次のメジャーエラーコードを含む。GSSException.BAD_NAMETYPE, GSSException.FAILURE
  - equals
```
boolean equals(Object another)
```
    この GSSName オブジェクトを、GSSName である可能性がある別のオブジェクトと比較します。このメソッドの動作は、GSSException をスローしない点を除いて、equals と同じです。エラーが発生した場合は false を返します。
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    another - この名前と比較するオブジェクト
    
    戻り値:
    比較するオブジェクトが GSSName で、2 つの名前が同じエンティティーを参照している場合は true。
    関連項目:
    equals(GSSName)
  - hashCode
```
int hashCode()
```
    この GSSName のハッシュコード値を返します。
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    hashCode 値
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - canonicalize
```
GSSName canonicalize(Oid mech)
                     throws GSSException
```
    特定のメカニズムに対して標準化される名前を作成します。
    
    パラメータ:
    mech - この名前の標準化がリクエストされるときの基準とするメカニズムの OID。
    
    戻り値:
    特定のメカニズムに標準化された名前を表す基本要素だけで構成される GSSName。
    
    例外:
    
    GSSException - 次のメジャーエラーコードを含む。GSSException.BAD_MECH, GSSException.BAD_NAMETYPE, GSSException.BAD_NAME, GSSException.FAILURE
  - export
```
byte[] export()
              throws GSSException
```
    標準化されたメカニズム名 (MN) を連続するバイト表現として返します。この表現は、承認機能が名前をバイト単位に直接比較するときに適しています。MN でない名前の場合は、NAME_NOT_MN 状態コードが設定された GSSException がスローされることがあります。例外がスローされないようにするには、システム固有のデフォルトのメカニズムを使用して名前を正規化してから、エクスポートする必要があります。エクスポートされた名前オブジェクトは、ヘッダーとトレーラから構成されます。ヘッダーには、名前を認証したメカニズムを識別する OID が含まれます。トレーラには、名前自体が含まれます。トレーラの構文は、各メカニズムの仕様によって定義されます。出力バッファーのヘッダーの形式は、RFC 2743 に指定されています。
    エクスポートされた名前は、大きなアクセス制御リストで使用します。アクセス制御リストが大きい場合は、各名前に対して GSSName オブジェクトを作成し、ACL から equals メソッドを呼び出すときのオーバーヘッドが大きくなることがあります。
    エクスポートされた名前を再インポートするには、byte 配列のファクトリメソッド GSSManager.createName を使用し、名前型のオブジェクト識別子として NT_EXPORT_NAME を指定します。その結果として返される GSSName 名も MN です。
    
    戻り値:
    エクスポートされた名前を含む byte[]。RFC 2743 には、この byte 配列に使用する、メカニズムに依存しないエクスポートされた名前オブジェクトの形式が定義されている。
    
    例外:
    
    GSSException - 次のメジャーエラーコードを含む。GSSException.BAD_NAME, GSSException.BAD_NAMETYPE, GSSException.FAILURE
  - toString
```
String toString()
```
    GSSName オブジェクトのテキスト表現を返します。出力された名前の形式 (返される文字列の構文を決定する) を取り出す場合は、getStringNameType メソッドを使用します。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    プリント可能な形式でこの名前を表現する String。
  - getStringNameType
```
Oid getStringNameType()
                      throws GSSException
```
    この名前のプリント可能な表現の名前型を返します。 toString メソッドからは、この名前型で返されます。
    
    戻り値:
    toString メソッドから返される名前の名前空間を表す OID。
    
    例外:
    
    GSSException - 次のメジャーエラーコードを含む。 GSSException.FAILURE
  - isAnonymous
```
boolean isAnonymous()
```
    この名前オブジェクトが匿名のエンティティーを表しているかどうかテストします。
    
    戻り値:
    匿名の名前である場合は true、そうでない場合は false。
  - isMN
```
boolean isMN()
```
    この名前オブジェクトがメカニズム名 (MN) を表しているかどうかテストします。MN は、特定のメカニズムの基本名前要素を含む GSSName です。
    
    戻り値:
    MN である場合は true、そうでない場合は false。

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース GSSName

フィールドのサマリー

メソッドのサマリー

フィールドの詳細

NT_HOSTBASED_SERVICE

NT_USER_NAME

NT_MACHINE_UID_NAME

NT_STRING_UID_NAME

NT_ANONYMOUS

NT_EXPORT_NAME

メソッドの詳細

equals

equals

hashCode

canonicalize

export

toString

getStringNameType

isAnonymous

isMN