summaryrefslogtreecommitdiff
path: root/java/JACE/Connection/AcceptStrategy.java
blob: 3af87865c798abadb01c53cddfa09d4fe7862571 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
/*************************************************
 *
 * = PACKAGE
 *    JACE.Connection
 *
 * = FILENAME
 *    AcceptStrategy.java
 *
 *@author Prashant Jain
 *@author Everett Anderson
 *
 *************************************************/
package JACE.Connection;

import java.io.*;
import java.net.*;
import JACE.SOCK_SAP.*;

/**
 * Interface for specifying a passive connection
 * acceptance strategy for a 
 * <a href="ACE.Connection.SvcHandler.html"><tt>SvcHandler</tt></a>
 * .
 * <P>
 * This class provides a strategy that manages passive
 * connection setup for an application, and can be extended
 * to define new strategies.
 * <P>
 *
 * The default implementation delegates to a generic Acceptor.
 *
 *@see SvcHandler
 *@see Acceptor
 */
public class AcceptStrategy
{
  /**
   * Create an instance of AcceptStrategy that delegates to the given
   * Acceptor.
   *@param port port number where the server will listen for connections
   *@param peer Acceptor instance to delegate to
   */
  AcceptStrategy (int port, Acceptor peer) throws IOException
  {
    this.acceptor_ = peer;
    this.open (port);
  }

  /**
   * Create an instance of Accept Strategy that delegates to Acceptor.
   *@param port port number where the server will listen for connections
   *@exception IOException couldn't open port
   */
  AcceptStrategy (int port) throws IOException
  {
    this.acceptor_ = new Acceptor ();
    this.open (port);
  }

  /**
   * Initialize AcceptStrategy.
   *@param port port number where the server will listen for connections
   *@exception IOException couldn't open port
   */
  public void open (int port) throws IOException
  {
    this.acceptor_.open (port);
  }

  /**
   * Accept connections into the SvcHandler. Note that subclasses
   * should overwrite this method to provide a different accept
   * strategy.
   *@param sh Svc Handler in which to accept the connection
   *@exception SocketException Socket error
   *@exception IOException Socket error
   *@return 0
   */
  public int acceptSvcHandler (SvcHandler sh) throws
  SocketException, IOException
    {
      return this.acceptor_.acceptSvcHandler (sh);
    }

  // The Acceptor we delegate to (if any)
  private Acceptor acceptor_;
}