jdk-sandbox: src/java.net.http/share/classes/java/net/http/package-info.java@ee6f7a61f3a5 (annotated)

42460 7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	1	/*
49765 ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	2	* Copyright (c) 2015, 2018, Oracle and/or its affiliates. All rights reserved.
42460 7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	3	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	4	*
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	5	* This code is free software; you can redistribute it and/or modify it
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	6	* under the terms of the GNU General Public License version 2 only, as
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	7	* published by the Free Software Foundation. Oracle designates this
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	8	* particular file as subject to the "Classpath" exception as provided
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	9	* by Oracle in the LICENSE file that accompanied this code.
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	10	*
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	11	* This code is distributed in the hope that it will be useful, but WITHOUT
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	12	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	13	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	14	* version 2 for more details (a copy is included in the LICENSE file that
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	15	* accompanied this code).
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	16	*
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	17	* You should have received a copy of the GNU General Public License version
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	18	* 2 along with this work; if not, write to the Free Software Foundation,
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	19	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	20	*
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	21	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	22	* or visit www.oracle.com if you need additional information or have any
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	23	* questions.
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	24	*/
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	25
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	26	/**
49765 ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	27	* <h2>HTTP Client and WebSocket APIs</h2>
42460 7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	28	*
43302 45de1dc92ecd 8173354: javadoc warning notice for types in Incubator Modules chegar parents: 42460 diff changeset	29	* <p> Provides high-level client interfaces to HTTP (versions 1.1 and 2) and
49765 ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	30	* low-level client interfaces to WebSocket. The main types defined are:
42460 7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	31	*
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	32	* <ul>
49765 ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	33	* <li>{@link java.net.http.HttpClient}</li>
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	34	* <li>{@link java.net.http.HttpRequest}</li>
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	35	* <li>{@link java.net.http.HttpResponse}</li>
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	36	* <li>{@link java.net.http.WebSocket}</li>
42460 7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	37	* </ul>
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	38	*
49765 ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	39	* <p> The protocol-specific requirements are defined in the
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	40	* <a href="https://tools.ietf.org/html/rfc7540">Hypertext Transfer Protocol
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	41	* Version 2 (HTTP/2)</a>, the <a href="https://tools.ietf.org/html/rfc2616">
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	42	* Hypertext Transfer Protocol (HTTP/1.1)</a>, and
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	43	* <a href="https://tools.ietf.org/html/rfc6455">The WebSocket Protocol</a>.
42460 7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	44	*
49765 ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	45	* <p> Asynchronous tasks and dependent actions of returned {@link
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	46	* java.util.concurrent.CompletableFuture} instances are executed on the threads
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	47	* supplied by the client's {@link java.util.concurrent.Executor}, where
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	48	* practical.
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	49	*
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	50	* <p> {@code CompletableFuture}s returned by this API will throw {@link
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	51	* java.lang.UnsupportedOperationException} for their {@link
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	52	* java.util.concurrent.CompletableFuture#obtrudeValue(Object) obtrudeValue}
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	53	* and {@link java.util.concurrent.CompletableFuture#obtrudeException(Throwable)
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	54	* obtrudeException} methods. Invoking the {@link
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	55	* java.util.concurrent.CompletableFuture#cancel cancel} method on a {@code
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	56	* CompletableFuture} returned by this API will not interrupt the underlying
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	57	* operation, but may be useful to complete, exceptionally, dependent stages
ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	58	* that have not already completed.
42460 7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	59	*
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	60	* <p> Unless otherwise stated, {@code null} parameter values will cause methods
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	61	* of all classes in this package to throw {@code NullPointerException}.
7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	62	*
49765 ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	63	* @since 11
42460 7133f144981a 8170648: Move java.net.http package out of Java SE to incubator namespace michaelm parents: diff changeset	64	*/
49765 ee6f7a61f3a5 8197564: HTTP Client implementation chegar parents: 48083 diff changeset	65	package java.net.http;

author	chegar
	Tue, 17 Apr 2018 08:54:17 -0700
changeset 49765	ee6f7a61f3a5
parent 48083	src/jdk.incubator.httpclient/share/classes/jdk/incubator/http/package-info.java@b1c1b4ef4be2
child 50681	4254bed3c09d
child 56451	9585061fdb04
permissions	-rw-r--r--