org.simpleframework.http.connect.Notifier Maven / Gradle / Ivy

Go to download
/*
 * Notifier.java October 2002
 *
 * Copyright (C) 2002, Niall Gallagher 
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation.
 *
 * This library 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 Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General 
 * Public License along with this library; if not, write to the 
 * Free Software Foundation, Inc., 59 Temple Place, Suite 330, 
 * Boston, MA  02111-1307  USA
 */
 
package org.simpleframework.http.connect;

import static java.nio.channels.SelectionKey.OP_ACCEPT;

import java.net.SocketAddress;

import javax.net.ssl.SSLContext;

import org.simpleframework.http.Server;
import org.simpleframework.util.select.DirectReactor;
import org.simpleframework.util.select.Reactor;

/**
 * The Notifier object is represents the interface to
 * the server that the clients can connect to. This is responsible
 * for making call backs to the Acceptor when there
 * is a new connection waiting to be accepted. When the connection
 * is to be closed the interface object can be closed.
 * 
 * @author Niall Gallagher 
 */
class Notifier {      
   
   /**
    * This is the acceptor that is used to accept the connections.
    */
   private Acceptor acceptor;
   
   /**
    * This is the reactor used to notify the acceptor of sockets.
    */
   private Reactor reactor;
   
   /**
    * Constructor for the Notifier object. This needs
    * a socket address and a processor to hand created pipelines
    * to. This creates a Reactor which will notify the
    * acceptor when there is a new connection waiting to be accepted.
    * 
    * @param address this is the address to listen for new sockets
    * @param processor this is where pipelines are handed to
    */
   public Notifier(SocketAddress address, Server processor) throws Exception {
      this(address, null, processor);
   }
   
   /**
    * Constructor for the Notifier object. This needs
    * a socket address and a processor to hand created pipelines
    * to. This creates a Reactor which will notify the
    * acceptor when there is a new connection waiting to be accepted.
    * 
    * @param address this is the address to listen for new sockets
    * @param engine this is the SSL engine used for secure HTTPS
    * @param processor this is where pipelines are handed to
    */
   public Notifier(SocketAddress address, SSLContext context, Server processor) throws Exception {
      this.acceptor = new Acceptor(address, context, processor);
      this.reactor = new DirectReactor();
      this.process();
   }
   
   /**
    * This is used to register the Acceptor to listen
    * for new connections that are ready to be accepted. Once this
    * is registered it will remain registered until the interface
    * is closed, at which point the socket is closed.
    * 
    * @throws Exception thrown if there is a problem registering
    */
   private void process() throws Exception {
      reactor.process(acceptor, OP_ACCEPT);
   }
   
   /**
    * This is used to close the connection and the server socket
    * used to accept connections. This will perform a close of the
    * connected server socket that have been created from using
    * the Acceptor object. 
    * 
    * @throws Exception thrown if there is a problem closing
    */   
   public void close() throws Exception {
      acceptor.close();
      reactor.stop();
   }
}