server/ACL/ACLServerSocket.java

//---PACKAGE DECLARATION---
//package uk.org.iscream.cms.server.util;

//---IMPORTS---
import uk.org.iscream.cms.server.util.*;
import java.net.ServerSocket;
import java.net.Socket;
import java.net.InetAddress;
import java.io.IOException;

/**
 * Access Control List ServerSocket wrapper
 *
 * @author  $Author$
 * @version $Id$
 */
public class ACLServerSocket extends ServerSocket {

//---FINAL ATTRIBUTES---

    /**
     * The current CVS revision of this class
     */
    public static final String REVISION = "$Revision$";

//---STATIC METHODS---

//---CONSTRUCTORS---

    public ACLServerSocket(int port) throws IOException {
        super(port);
        setACL(new ACL());
    }
    
    public ACLServerSocket(int port, int backlog) throws IOException {
        super(port, backlog);
        setACL(new ACL());
    }
    
    public ACLServerSocket(int port, int backlog, InetAddress bindAddr) throws IOException {
        super(port, backlog, bindAddr);
        setACL(new ACL());
    }
    
    public ACLServerSocket(ACL acl, int port) throws IOException {
        super(port);
        setACL(acl);
    }
    
    public ACLServerSocket(ACL acl, int port, int backlog) throws IOException {
        super(port, backlog);
        setACL(acl);
    }
    
    public ACLServerSocket(ACL acl, int port, int backlog, InetAddress bindAddr) throws IOException {
        super(port, backlog, bindAddr);
        setACL(acl);
    }

//---PUBLIC METHODS---

    public Socket accept() throws IOException {
        while(true) {
            Socket s = super.accept();
            if(_acl.check(s.getInetAddress())) {
                return s;
            }
            else {
                s.close();
            }
        }
    }
    
    public void setACL(ACL acl) {
        _acl = acl;
    }
    
    /**
     * Overrides the {@link java.lang.Object#toString() Object.toString()}
     * method to provide clean logging (every class should have this).
     *
     * This uses the uk.org.iscream.cms.server.util.FormatName class
     * to format the toString()
     *
     * @return the name of this class and its CVS revision
     */
    public String toString() {
        return FormatName.getName(
            _name,
            getClass().getName(),
            REVISION);
    }

//---PRIVATE METHODS---

//---ACCESSOR/MUTATOR METHODS---

//---ATTRIBUTES---

    /**
     * This is the friendly identifier of the
     * component this class is running in.
     * eg, a Filter may be called "filter1",
     * If this class does not have an owning
     * component,  a name from the configuration
     * can be placed here.  This name could also
     * be changed to null for utility classes.
     */
    private String _name = null;
    
    private ACL _acl;
    
//---STATIC ATTRIBUTES---

//---INNER CLASSES---

}
Revision:	1.1
Committed:	Wed Dec 19 23:43:27 2001 UTC (22 years, 4 months ago) by tdb
Branch:	MAIN
Log Message:	Initial checkin of ACL code for i-scream server. At present it should allow for ServerSocket's to be wrapped up with an access control list. Very simple to use, will javadoc sometime soon. Essentially construct a ACLServerSocket instead of a ServerSocket, then set an ACL (defaults to open ACL). Then it can be used as a ServerSocket due to inheritance, and will only return from the allow() method if the connecting Socket is permitted by the ACL.
#	User	Rev	Content
1	tdb	1.1	//---PACKAGE DECLARATION---
2			//package uk.org.iscream.cms.server.util;
3
4			//---IMPORTS---
5			import uk.org.iscream.cms.server.util.*;
6			import java.net.ServerSocket;
7			import java.net.Socket;
8			import java.net.InetAddress;
9			import java.io.IOException;
10
11			/**
12			* Access Control List ServerSocket wrapper
13			*
14			* @author $Author$
15			* @version $Id$
16			*/
17			public class ACLServerSocket extends ServerSocket {
18
19			//---FINAL ATTRIBUTES---
20
21			/**
22			* The current CVS revision of this class
23			*/
24			public static final String REVISION = "$Revision$";
25
26			//---STATIC METHODS---
27
28			//---CONSTRUCTORS---
29
30			public ACLServerSocket(int port) throws IOException {
31			super(port);
32			setACL(new ACL());
33			}
34
35			public ACLServerSocket(int port, int backlog) throws IOException {
36			super(port, backlog);
37			setACL(new ACL());
38			}
39
40			public ACLServerSocket(int port, int backlog, InetAddress bindAddr) throws IOException {
41			super(port, backlog, bindAddr);
42			setACL(new ACL());
43			}
44
45			public ACLServerSocket(ACL acl, int port) throws IOException {
46			super(port);
47			setACL(acl);
48			}
49
50			public ACLServerSocket(ACL acl, int port, int backlog) throws IOException {
51			super(port, backlog);
52			setACL(acl);
53			}
54
55			public ACLServerSocket(ACL acl, int port, int backlog, InetAddress bindAddr) throws IOException {
56			super(port, backlog, bindAddr);
57			setACL(acl);
58			}
59
60			//---PUBLIC METHODS---
61
62			public Socket accept() throws IOException {
63			while(true) {
64			Socket s = super.accept();
65			if(_acl.check(s.getInetAddress())) {
66			return s;
67			}
68			else {
69			s.close();
70			}
71			}
72			}
73
74			public void setACL(ACL acl) {
75			_acl = acl;
76			}
77
78			/**
79			* Overrides the {@link java.lang.Object#toString() Object.toString()}
80			* method to provide clean logging (every class should have this).
81			*
82			* This uses the uk.org.iscream.cms.server.util.FormatName class
83			* to format the toString()
84			*
85			* @return the name of this class and its CVS revision
86			*/
87			public String toString() {
88			return FormatName.getName(
89			_name,
90			getClass().getName(),
91			REVISION);
92			}
93
94			//---PRIVATE METHODS---
95
96			//---ACCESSOR/MUTATOR METHODS---
97
98			//---ATTRIBUTES---
99
100			/**
101			* This is the friendly identifier of the
102			* component this class is running in.
103			* eg, a Filter may be called "filter1",
104			* If this class does not have an owning
105			* component, a name from the configuration
106			* can be placed here. This name could also
107			* be changed to null for utility classes.
108			*/
109			private String _name = null;
110
111			private ACL _acl;
112
113			//---STATIC ATTRIBUTES---
114
115			//---INNER CLASSES---
116
117			}