1 /* 2 * Copyright 1999-2004 The Apache Software Foundation 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 12 * implied. 13 * 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 */ 17 18 package org.apache.avalon.cornerstone.services.sockets; 19 20 /** 21 * Service to manager the socket factories. 22 * 23 * @author Peter Donald 24 */ 25 public interface SocketManager 26 { 27 String ROLE = SocketManager.class.getName(); 28 29 /** 30 * Retrieve a server socket factory by name. 31 * 32 * @param name the name of server socket factory 33 * @return the ServerSocketFactory 34 * @exception Exception if server socket factory is not available 35 */ 36 ServerSocketFactory getServerSocketFactory( String name ) 37 throws Exception; 38 39 /** 40 * Retrieve a client socket factory by name. 41 * 42 * @param name the name of client socket factory 43 * @return the SocketFactory 44 * @exception Exception if socket factory is not available 45 */ 46 SocketFactory getSocketFactory( String name ) 47 throws Exception; 48 } 49