优惠码 第68页

FileNameMap public interface FileNameMap 一个简单的接口，它提供了一种在文件名和 MIME 类型字符串之间进行映射的机制。 方法总结 修饰符和类型 方法 描述 String getContentTypeFor(String fileName) Gets the MIME type for the specified file name. 方法详情 getContentTypeFor String getContentTypeFor(String fileName) 获取指定文件名的 MIME 类型。 参数： 参数名称 参数描述 fileName 指定的文件名 返回: 一个字符串，指示指定文件名的 MIME 类型。

DatagramSocketImplFactory public interface DatagramSocketImplFactory 该接口为数据报套接字实现定义了一个工厂。 DatagramSocket 类使用它来创建实际的套接字实现。 方法总结 修饰符和类型 方法 描述 DatagramSocketImpl createDatagramSocketImpl() 创建一个新的 DatagramSocketImpl 实例。 方法详情 createDatagramSocketImpl DatagramSocketImpl createDatagramSocketImpl() 创建一个新的 DatagramSocketImpl 实例。 返回: DatagramSocketImpl 的新实例。

CookieStore public interface CookieStore CookieStore 对象表示 cookie 的存储。 可以存储和检索cookies。 CookieManager 将调用 CookieStore.add 为每个传入的 HTTP 响应保存 cookie，并调用 CookieStore.get 为每个传出的 HTTP 请求检索 cookie。 CookieStore 负责删除已过期的 HttpCookie 实例。 方法总结 修饰符和类型 方法 描述 void add(URI uri, HttpCookie cookie) 将一个 HTTP cookie 添加到存储中。 ListHttpCookie get(URI uri) 检索与给定 URI 关联的 cookie，或者其域与给定 URI 匹配的 cookie。 ListHttpCookie getCookies() 在 cookie 存储中获取所有未过期的 cookie。 ListURI getURIs() 获取标识此 cookie 存储中的 cookie 的所有 URI。 boolean remove(URI uri, HttpCookie cookie) 从存储中删除 cookie。 boolean removeAll() 删除此 cookie 存储中的所有 cookie。 方法详情 add void add(URI uri, HttpCookie cookie) 将一个 HTTP cookie 添加到存储中。 每个传入的 HTTP 响应都会调用它。 要存储的 cookie 可能与 URI 相关联，也可能不相关。 如果它不与 URI 关联，则 cookie 的域和路径属性将指示它来自何处。 如果它与 URI 相关联并且未指定其域和路径属性，则给定的 URI 将指示此 cookie 的来源。 如果与给定 URI 对应的 cookie 已经存在，则将其替换为新的。 参数： 参数名称 参数描述 uri 与此 cookie 关联的 uri。 如果为 null，则此 cookie 不会与 URI 关联 cookie 要存储的 cookie Throws: Throw名称 Throw描述 NullPointerException 如果 cookie 为空 get ListHttpCookie get(URI uri) 检索与给定 URI 关联的 cookie，或者其域与给定 URI 匹配的 cookie。 仅返回未过期的 cookie。 每个传出的 HTTP 请求都会调用它。 参数： 参数名称 参数描述 uri 与要返回的 cookie 关联的 uri 返回: 一个不可变的 HttpCookie 列表，如果没有...

CookiePolicy public interface CookiePolicy CookiePolicy 实现决定哪些 cookie 应该被接受，哪些应该被拒绝。 提供了三种预定义的策略实现，即 ACCEPT_ALL、ACCEPT_NONE 和 ACCEPT_ORIGINAL_SERVER。 字段摘要 修饰符和类型 字段 描述 static CookiePolicy ACCEPT_ALL 一种接受所有 cookie 的预定义策略。 static CookiePolicy ACCEPT_NONE 一种不接受 cookie 的预定义策略。 static CookiePolicy ACCEPT_ORIGINAL_SERVER 一种仅接受来自原始服务器的 cookie 的预定义策略。 方法总结 修饰符和类型 方法 描述 boolean shouldAccept(URI uri, HttpCookie cookie) 将被调用以查看是否应接受此 cookie。 字段详细信息 ACCEPT_ALL static final CookiePolicy ACCEPT_ALL 一种接受所有 cookie 的预定义策略。 ACCEPT_NONE static final CookiePolicy ACCEPT_NONE 一种不接受 cookie 的预定义策略。 ACCEPT_ORIGINAL_SERVER static final CookiePolicy ACCEPT_ORIGINAL_SERVER 一种仅接受来自原始服务器的 cookie 的预定义策略。 方法详情 shouldAccept boolean shouldAccept(URI uri, HttpCookie cookie) 将被调用以查看是否应接受此 cookie。 参数： 参数名称 参数描述 uri 用于咨询接受策略的 URI cookie 有问题的 HttpCookie 对象 返回: 如果应接受此 cookie，则为 true； 否则为false

ContentHandlerFactory public interface ContentHandlerFactory 该接口为内容处理程序定义了一个工厂。 此接口的实现应将 MIME 类型映射到 ContentHandler 的实例。 URLStreamHandler 类使用此接口为 MIME 类型创建 ContentHandler。 方法总结 修饰符和类型 方法 描述 ContentHandler createContentHandler(String mimetype) 创建一个新的 ContentHandler 以从 URLStreamHandler 读取对象。 方法详情 createContentHandler ContentHandler createContentHandler(String mimetype) 创建一个新的 ContentHandler 以从 URLStreamHandler 读取对象。 参数： 参数名称 参数描述 mimetype 需要内容处理程序的 MIME 类型。 返回: 一个新的 ContentHandler 从 URLStreamHandler 读取对象。

SuppressWarnings @Target({TYPE,FIELD,METHOD,PARAMETER,CONSTRUCTOR,LOCAL_VARIABLE}) @Retention(SOURCE) public @interface SuppressWarnings 指示应在带注释的元素（以及带注释的元素中包含的所有程序元素）中抑制命名的编译器警告。 请注意，给定元素中抑制的警告集是所有包含元素中抑制的警告的超集。 例如，如果您注释一个类以抑制一个警告并注释一个方法以抑制另一个警告，则两个警告都将在方法中被抑制。 作为风格问题，程序员应该始终在最有效的嵌套元素上使用此注释。 如果您想在特定方法中抑制警告，您应该注释该方法而不是它的类。 所需元素摘要 修饰符和类型 必需元素 描述 String[] value 编译器要在带注释的元素中抑制的一组警告。 元素详细信息 value String[] value 编译器要在带注释的元素中抑制的一组警告。 允许重复名称。 名称的第二次和连续出现将被忽略。 存在无法识别的警告名称不是错误：编译器必须忽略它们无法识别的任何警告名称。 但是，如果注释包含无法识别的警告名称，它们可以自由发出警告。 字符串“unchecked”用于抑制未经检查的警告。 编译器供应商应结合此注释类型记录他们支持的其他警告名称。 鼓励他们合作以确保相同的名称在多个编译器中工作。 返回: 要抑制的警告集

SafeVarargs @Documented @Retention(RUNTIME) @Target({CONSTRUCTOR,METHOD}) public @interface SafeVarargs 程序员断言带注释的方法或构造函数的主体不会对其 varargs 参数执行潜在的不安全操作。 将此注释应用于方法或构造函数会抑制有关不可具体化的变量 arity (vararg) 类型的未经检查的警告，并抑制有关在调用站点创建参数化数组的未经检查的警告。 除了 Target 元注解施加的使用限制外，编译器还需要对该注解类型实施额外的使用限制； 如果使用 @SafeVarargs 注释对方法或构造函数声明进行注释，则这是编译时错误，并且： 声明是固定数量的方法或构造函数 声明是一个既不是静态也不是最终的变量arity 方法。 鼓励编译器在将此注释类型应用于方法或构造函数声明时发出警告，其中： 可变arity 参数具有可具体化的元素类型，包括原始类型、Object 和String。 （对于可具体化的元素类型，此注释类型抑制的未经检查的警告已经不会出现。） 方法或构造函数声明的主体执行潜在的不安全操作，例如对变量 arity 参数数组的元素的赋值会生成未经检查的警告。 一些不安全的操作不会触发未经检查的警告。 例如，别名在 @SafeVarargs // Not actually safe! static void m(List<String>... stringLists) { Object[] array = stringLists; List<Integer> tmpList = Arrays.asList(42); array[0] = tmpList; // Semantically invalid, but compiles without warnings String s = stringLists[0].get(0); // Oh no, ClassCastException at runtime! } 在运行时导致 ClassCastException。 该平台的未来版本可能会要求此类不安全操作出现编译器错误。

Override @Target(METHOD) @Retention(SOURCE) public @interface Override 指示方法声明旨在覆盖超类型中的方法声明。 如果使用此注解类型对方法进行注解，则编译器需要生成错误消息，除非至少满足以下条件之一： 该方法确实覆盖或实现了在超类型中声明的方法。 该方法的签名与 Object 中声明的任何公共方法的签名等效。