/* * Copyright (c) 2014, 2022, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions.
*/
/** * Defines the JDK-specific HTTP server API, and provides the jwebserver tool * for running a minimal HTTP server. * * <p>The {@link com.sun.net.httpserver} package defines a high-level API for * building servers that support HTTP and HTTPS. The SimpleFileServer class * implements a simple HTTP-only file server intended for testing, development * and debugging purposes. A default implementation is provided via the * {@code jwebserver} tool and the main entry point of the module, which can * also be invoked with {@code java -m jdk.httpserver}. * * <p>The {@link com.sun.net.httpserver.spi} package specifies a Service Provider * Interface (SPI) for locating HTTP server implementations based on the * {@code com.sun.net.httpserver} API. * <p> * <b id="httpserverprops">System properties used by the HTTP server API</b> * <p> * The following is a list of JDK specific system properties used by the default HTTP * server implementation in the JDK. Any properties below that take a numeric value * assume the default value if given a string that does not parse as a number. * <ul> * <li><p><b>{@systemProperty sun.net.httpserver.idleInterval}</b> (default: 30 sec)<br> * Maximum duration in seconds which an idle connection is kept open. This timer * has an implementation specific granularity that may mean that idle connections are * closed later than the specified interval. Values less than or equal to zero are mapped * to the default setting. * </li> * <li><p><b>{@systemProperty jdk.httpserver.maxConnections}</b> (default: -1)<br> * The maximum number of open connections at a time. This includes active and idle connections. * If zero or negative, then no limit is enforced. * </li> * <li><p><b>{@systemProperty sun.net.httpserver.maxIdleConnections}</b> (default: 200)<br> * The maximum number of idle connections at a time. If set to zero or a negative value * then connections are closed after use. * </li> * <li><p><b>{@systemProperty sun.net.httpserver.drainAmount}</b> (default: 65536)<br> * The maximum number of bytes that will be automatically read and discarded from a * request body that has not been completely consumed by its * {@link com.sun.net.httpserver.HttpHandler HttpHandler}. If the number of remaining * unread bytes are less than this limit then the connection will be put in the idle connection * cache. If not, then it will be closed. * </li> * <li><p><b>{@systemProperty sun.net.httpserver.maxReqHeaders}</b> (default: 200)<br> * The maxiumum number of header fields accepted in a request. If this limit is exceeded * while the headers are being read, then the connection is terminated and the request ignored. * If the value is less than or equal to zero, then the default value is used. * </li> * <li><p><b>{@systemProperty sun.net.httpserver.maxReqTime}</b> (default: -1)<br> * The maximum time in milliseconds allowed to receive a request headers and body. * In practice, the actual time is a function of request size, network speed, and handler * processing delays. A value less than or equal to zero means the time is not limited. * If the limit is exceeded then the connection is terminated and the handler will receive a * {@link java.io.IOException}. This timer has an implementation specific granularity * that may mean requests are aborted later than the specified interval. * </li> * <li><p><b>{@systemProperty sun.net.httpserver.maxRspTime}</b> (default: -1)<br> * The maximum time in milliseconds allowed to receive a response headers and body. * In practice, the actual time is a function of response size, network speed, and handler * processing delays. A value less than or equal to zero means the time is not limited. * If the limit is exceeded then the connection is terminated and the handler will receive a * {@link java.io.IOException}. This timer has an implementation specific granularity * that may mean responses are aborted later than the specified interval. * </li> * <li><p><b>{@systemProperty sun.net.httpserver.nodelay}</b> (default: false)<br> * Boolean value, which if true, sets the {@link java.net.StandardSocketOptions#TCP_NODELAY TCP_NODELAY} * socket option on all incoming connections. * </li></ul> * * @toolGuide jwebserver * * @uses com.sun.net.httpserver.spi.HttpServerProvider * * @moduleGraph * @since 9
*/
module jdk.httpserver {
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.