CodeSource (Java Platform SE 7)

java.lang.Object
- java.security.CodeSource

すべての実装されたインタフェース:

Serializable
```
public class CodeSource
extends Object
implements Serializable
```
このクラスはコードベースの概念を拡張し、位置 (URL) に加えて、その位置から発生する署名付きコードの検証に使用した証明書チェーンもカプセル化します。

関連項目:
直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`CodeSource(URL url, Certificate[] certs)` CodeSource を構築し、指定された位置と証明書セットに関連付けます。
`CodeSource(URL url, CodeSigner[] signers)` CodeSource を構築し、それを指定された位置とコード署名者セットに関連付けます。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`boolean`	`equals(Object obj)` 指定されたオブジェクトとこのオブジェクトが等価であるかどうかをテストします。
`Certificate[]`	`getCertificates()` この CodeSource に関連した証明書を返します。
`CodeSigner[]`	`getCodeSigners()` この CodeSource に関連したコード署名者を返します。
`URL`	`getLocation()` この CodeSource に関連した位置を返します。
`int`	`hashCode()` このオブジェクトのハッシュコード値を返します。
`boolean`	`implies(CodeSource codesource)` この CodeSource オブジェクトが指定された CodeSource を「包含」している場合に true を返します。
`String`	`toString()` この CodeSource を説明する文字列を返すことにより、その URL と証明書を示します。

クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - CodeSource
```
public CodeSource(URL url,
          Certificate[] certs)
```
    CodeSource を構築し、指定された位置と証明書セットに関連付けます。
    
    パラメータ:
    url - 位置 (URL)。
    certs - 証明書。null も指定できる。この配列の内容は、後続の変更に影響されないようにコピーされる。
  - CodeSource
```
public CodeSource(URL url,
          CodeSigner[] signers)
```
    CodeSource を構築し、それを指定された位置とコード署名者セットに関連付けます。
    
    パラメータ:
    url - 位置 (URL)。
    signers - コード署名者。null も指定できる。この配列の内容は、後続の変更に影響されないようにコピーされる。
    導入されたバージョン:
    
    1.5
- メソッドの詳細
  - hashCode
```
public int hashCode()
```
    このオブジェクトのハッシュコード値を返します。
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    このオブジェクトのハッシュコード値。
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(Object obj)
```
    指定されたオブジェクトとこのオブジェクトが等価であるかどうかをテストします。2 つの CodeSource オブジェクトは、それらの位置が同じ値であり、かつ署名者の証明書チェーンが同じ値である場合に同等と見なされます。ただし、証明書チェーンの順序は同じでなくてもかまいません。
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    obj - このオブジェクトと等しいかどうかが判定されるオブジェクト。
    
    戻り値:
    オブジェクトが等しいと見なされた場合は true、そうでない場合は false。
    関連項目:
    Object.hashCode()、HashMap
  - getLocation
```
public final URL getLocation()
```
    この CodeSource に関連した位置を返します。
    
    戻り値:
    位置 (URL)
  - getCertificates
```
public final Certificate[] getCertificates()
```
    この CodeSource に関連した証明書を返します。
    この CodeSource オブジェクトが CodeSource(URL url, CodeSigner[] signers) コンストラクタを使って作成されたものである場合、その証明書チェーンが抽出および使用されて Certificate オブジェクトの配列が作成されます。各署名者証明書のあとにはそれをサポートする証明書チェーンが続きます (空である可能性もある)。各署名者証明書とそれをサポートする証明書チェーンは、下位から上位 (つまり署名者証明書が最初で (ルート) 証明書発行局が最後) の順に並びます。
    
    戻り値:
    証明書の配列のコピー。証明書が 1 つも存在しない場合は null。
  - getCodeSigners
```
public final CodeSigner[] getCodeSigners()
```
    この CodeSource に関連したコード署名者を返します。
    この CodeSource オブジェクトが CodeSource(URL url, Certificate[] certs) コンストラクタを使って作成されたものである場合、その証明書チェーンが抽出および使用されて CodeSigner オブジェクトの配列が作成されます。ただし、検査されるのは X.509 証明書だけであり、その他の種類の証明書はすべて無視されます。
    
    戻り値:
    コード署名者の配列のコピー。コード署名者が 1 つも存在しない場合は null。
    導入されたバージョン:
    
    1.5
  - implies
```
public boolean implies(CodeSource codesource)
```
    この CodeSource オブジェクトが指定された CodeSource を「包含」している場合に true を返します。
    具体的には、このメソッドは次の項目を順番に検査します。検査のどれかが失敗すると false を返し、すべての検査が成功すると true を返します。
    1. codesource が null ではない。
    2. このオブジェクトの証明書が null でない場合に、このオブジェクトの証明書がすべて codesource の証明書にある。
    3. このオブジェクトの位置 (getLocation()) が null でない場合に、このオブジェクトの位置と codesource の位置について次の項目を検査する。
      
      codesource の位置が null ではない。
      このオブジェクトの位置と codesource の位置が同じ場合は true を返す。
      このオブジェクトのプロトコル (getLocation().getProtocol()) は codesource のプロトコルと同じである。
      このオブジェクトのホスト (getLocation().getHost()) が null でない場合には、このオブジェクトのホストで構築した SocketPermission は、codesource のホストで生成した SocketPermission を包含している。
      このオブジェクトのポート (getLocation().getPort()) が -1 以外の場合 (つまり、ポートが指定されている場合) に、そのポートは codesource のポートと同じである。
      このオブジェクトのファイル (getLocation().getFile()) が codesource のファイルと異なる場合には、次の項目を検査する。このオブジェクトのファイルが「/-」で終わっている場合には、codesource のファイルはこのオブジェクトのファイルで始まる必要がある (末尾の「-」を除く)。このオブジェクトのファイルが「/*」で終わっている場合には、codesource のファイルはこのオブジェクトのファイルで始まる必要があり、また、このほかに「/」のセパレータがあってはならない。このオブジェクトのファイルが「/」で終わっていない場合には、このオブジェクトのファイルの末尾に「/」を追加することにより、codesource のファイルをこのオブジェクトのファイルに一致させる必要がある。
      このオブジェクトの参照 (getLocation().getRef()) が null でない場合に、その参照は codesource の参照と同じである。
    たとえば、次の位置にある、証明書が null のコードソースオブジェクトはすべて、位置が「http://java.sun.com/classes/foo.jar」で、証明書が null のコードソースを包含しています。
```
     http:
     http://*.sun.com/classes/*
     http://java.sun.com/classes/-
     http://java.sun.com/classes/foo.jar
 
```
    CodeSource の位置が null で、証明書チェーンが null の場合は、ほかの各 CodeSource を包含しています。
    パラメータ:
    codesource - 比較対象の CodeSource。
    
    戻り値:
    指定されたコードソースがこのコードソースによって包含されている場合は true、そうでない場合は false。
  - toString
```
public String toString()
```
    この CodeSource を説明する文字列を返すことにより、その URL と証明書を示します。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    この CodeSource についての情報

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

クラス CodeSource

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

CodeSource

CodeSource

メソッドの詳細

hashCode

equals

getLocation

getCertificates

getCodeSigners

implies

toString