1adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/* 2adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 3adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 4adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * this work for additional information regarding copyright ownership. 5adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 6adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * (the "License"); you may not use this file except in compliance with 7adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * the License. You may obtain a copy of the License at 8adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 9adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 10adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * 11adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 12adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 13adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * See the License for the specific language governing permissions and 15adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * limitations under the License. 16adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 17adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 18adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpackage javax.net; 19adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 20adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.io.IOException; 21adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.net.InetAddress; 22adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.net.ServerSocket; 23adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectimport java.net.SocketException; 24adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 25adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project/** 26adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * This abstract class defines methods to create server sockets. It can be 27adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * subclassed to create specific server socket types. 28adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 29adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Projectpublic abstract class ServerSocketFactory { 30f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson private static ServerSocketFactory defaultFactory; 31adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 32adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 33adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Gets the default server socket factory of the system which can be used to 34adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * create new server sockets without creating a subclass of this factory. 35f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson * 36adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the system default server socket factory. 37adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 38adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public static synchronized ServerSocketFactory getDefault() { 39adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project if (defaultFactory == null) { 40f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson defaultFactory = new DefaultServerSocketFactory(); 41adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 42adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project return defaultFactory; 43adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 44adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 45adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 46f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson * Creates a new {@code ServerSocketFactory} instance. 47f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson */ 48f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson protected ServerSocketFactory() { 49f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson } 50f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson 51f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson /** 52adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Creates a new server socket which is not bound to any local address. This 53adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * method has to be overridden by a subclass otherwise a {@code 54adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * SocketException} is thrown. 55f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson * 56adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the created unbound server socket. 57adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 58adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an error occurs while creating a new server socket. 59adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 60adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project public ServerSocket createServerSocket() throws IOException { 61f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson // follow RI's behavior 62adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project throw new SocketException("Unbound server sockets not implemented"); 63adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project } 64adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 65adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 664d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * Creates a new server socket which is bound to the given port with a 674d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * maximum backlog of 50 unaccepted connections. 68f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson * 694d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * @param port the port on which the created socket has to listen. 70adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the created bound server socket. 71adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @throws IOException 72adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * if an error occurs while creating a new server socket. 73adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 74f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson public abstract ServerSocket createServerSocket(int port) throws IOException; 75adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 76adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 77adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Creates a new server socket which is bound to the given port and 78adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * configures its maximum of queued connections. 79f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson * 804d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * @param port the port on which the created socket has to listen. 814d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * @param backlog the maximum number of unaccepted connections. Passing 0 or 824d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * a negative value yields the default backlog of 50. 83adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the created bound server socket. 844d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * @throws IOException if an error occurs while creating a new server socket. 85adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 86f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson public abstract ServerSocket createServerSocket(int port, int backlog) throws IOException; 87adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 88adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project /** 89adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * Creates a new server socket which is bound to the given address on the 90adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * specified port and configures its maximum of queued connections. 91f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson * 924d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * @param port the port on which the created socket has to listen. 934d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * @param backlog the maximum number of unaccepted connections. Passing 0 or 944d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * a negative value yields the default backlog of 50. 954d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * @param iAddress the address of the network interface which is used by the 964d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * created socket. 97adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project * @return the created bound server socket. 984d743816cad738bfeccf6dc210fc7c9bd84a8777Jesse Wilson * @throws IOException if an error occurs while creating a new server socket. 99adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project */ 100f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson public abstract ServerSocket createServerSocket(int port, int backlog, InetAddress iAddress) 101f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson throws IOException; 102adc854b798c1cfe3bfd4c27d68d5cee38ca617daThe Android Open Source Project 103f921579f87fa63204b4a4bef39ed27e7835aec45Jesse Wilson} 104