CodeSource (Java Platform SE 8 )

java.lang.Object
- java.security.CodeSource

All Implemented Interfaces:

Serializable
```
public class CodeSource
extends Object
implements Serializable
```
该类扩展了代码库的概念，不仅封装了位置（URL），还封装了用于验证源自该位置的签名代码的证书链。

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`CodeSource(URL url, Certificate[] certs)` 构造一个CodeSource，并将其与指定的位置和证书集合相关联。
`CodeSource(URL url, CodeSigner[] signers)` 构造CodeSource并将其与指定的位置和代码签名者集合相关联。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`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和证书。

Methods inherited from class 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)
```
    测试指定对象和此对象之间的相等性。如果两个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)构造那么它的证书链被提取并用于创建证书的对象的阵列。每个签名者证书后面都有其支持证书链（可能为空）。每个签名者证书及其支持证书链从底部到顶部订购（即，首先签名者证书和（根）证书颁发机构的最后）。
    
    结果
    
    证书数组的副本，如果没有则为null。
  - getCodeSigners
```
public final CodeSigner[] getCodeSigners()
```
    返回与此CodeSource相关联的代码签名者。
    如果此CodeSource对象是使用所创建的CodeSource(URL url, java.security.cert.Certificate[] certs)构造那么它的证书链被提取并用于创建目的CodeSigner对象的阵列。请注意，只检查X.509证书 - 所有其他证书类型都将被忽略。
    
    结果
    
    代码签名者数组的副本，如果没有，则返回null。
    
    从以下版本开始：
    
    1.5
  - implies
```
public boolean implies(CodeSource codesource)
```
    如果此CodeSource对象“暗示”指定的CodeSource，则返回true。
    更具体地说，该方法进行以下检查。如果有任何失败，则返回false。如果他们都成功，它将返回真实。
    - 代码不能为空。
    - 如果此对象的证书不为空，则该对象的所有证书必须存在于代码源证书中。
    - 如果此对象的位置（getLocation（））不为空，则对该对象的位置和代码源进行以下检查：
      
      codeource的位置不能为空。
      
      如果此对象的位置等于codeource的位置，则返回true。
      
      这个对象的协议（getLocation（）。getProtocol（））必须等于codeource的协议，忽略大小写。
      
      如果此对象的主机（getLocation（）。getHost（））不为空，则使用此对象的主机构建的SocketPermission必须意味着使用codesource主机构建的SocketPermission 。
      
      如果此对象的端口（getLocation（）。getPort（））不等于-1（即，如果指定了端口），则它必须等于codeource的端口或默认端口（codesource.getLocation（）。getDefaultPort（））。
      
      如果此对象的文件（getLocation（）。getFile（））不等于代码源的文件，则进行以下检查：如果此对象的文件以“/ - ”结尾，则代码源的文件必须以此对象的文件（尾随“ - ”）。如果该对象的文件以“/ *”结尾，则代码源的文件必须以此对象的文件开头，不得有任何其他“/”分隔符。如果此对象的文件不以“/”结尾，则代码源的文件必须与该对象的文件相匹配。
      
      如果这个对象的引用（getLocation（）。getRef（））不为null，它必须等于codeource的引用。
    例如，具有以下位置的代码源对象和空证书都表示代码源位置为“http://java.sun.com/classes/foo.jar”和空证书：
```
  http:
     http://*.sun.com/classes/*
     http://java.sun.com/classes/-
     http://java.sun.com/classes/foo.jar 
```
    请注意，如果此CodeSource具有空位置和空证书链，则它意味着每个其他CodeSource。
    参数
    
    codesource - CodeSource进行比较。
    
    结果
    
    如果代码源隐含指定的代码源，则为true，否则为false。
  - toString
```
public String toString()
```
    返回描述此CodeSource的字符串，告知其URL和证书。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    有关此CodeSource的信息。

Class CodeSource

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

CodeSource

CodeSource

方法详细信息

hashCode

equals

getLocation

getCertificates

getCodeSigners

implies

toString