avalon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dona...@apache.org
Subject cvs commit: avalon-apps/httpproxy/src/java/org/apache/avalon/httpproxy package.html
Date Thu, 10 Apr 2003 23:43:45 GMT
donaldp     2003/04/10 16:43:45

  Added:       httpproxy/src/java/org/apache/avalon/httpproxy package.html
  Log:
  Add in package.html docs
  
  Revision  Changes    Path
  1.1                  avalon-apps/httpproxy/src/java/org/apache/avalon/httpproxy/package.html
  
  Index: package.html
  ===================================================================
  <html>
  <body>
  
      <h1>Introduction</h1>
        <p>
          HTTP Proxy is a conventional HTTP proxy server that a browser would use to access
the internet from behind a firewall.  There are two components that are variations on the
same theme and use the same code base:
        </p>
        <ol>
          <li>
            <b>Auditing HTTP Proxy</b>  This logs the requests that it deals with.
          </li>
          <li>
            <b>Filtering HTTP Proxy</b>  This filters the requests that go out
and blocks some of them based on some configurable rules.
          </li>
        </ol>
        <p>
          One can be chained into the other such that you could filter and audit.
        </p>
  
      <h1>Packaging of SAR</h1>
        <p>
          It's much the same as the previous demo "helloworld" in that it's a socket listener
type app.  The assembly.xml file has a section for the configuration of this component and
it's zipped up into bar form in the same way.
        </p>
  
      <h1>Concepts shown here, not in HelloWorld</h1>
        <p>
          Apart from using it's own log, the main difference with this demo is that it provides
a mechanism by why the proxy server could be configured by another component that marked it
as a dependancy.  A number of methods provide a way for that block to configure settings at
runtime as well as query them:
        </p>
  <pre>
  public interface HttpFilteringProxyServer
      extends HttpProxyServer
  {
      /**
       * Method blockAllContentFrom No requests will reach this site.
       */
      void blockAllContentFrom( String domainName, boolean onOff );
  
      /**
       * Method allowCookiesFrom Allows Cookies to be sent to this site.
       * This is kinda redundant with some of the features of Netscape 4.x and 6.x
       */
      void allowCookiesFrom( String domainName, boolean onOff );
  
      /**
       * Method domainAllowed Check to see whether the appl domain should be blocked
       */
      boolean domainAllowed( String domainName );
  
      /**
       * Method cookieAllowed Check to see whether the appl domain can be sent cookies
       */
      boolean cookieAllowed( String domainName );
  
      /**
       * List the domains that are completely blocked.
       */
      String[] getBlockedDomains();
  
      /**
       * List the domains for which cookies are not sent.
       */
      String[] getCookieSuppressedDomains();
  }
  </pre>
  
      <h1>Status of demo</h1>
        <p>
          The component is in demo status and would take some extra work to get it working
to a level where it could be used for real as a proxy server.
        </p>
  </body>
  </html>
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@avalon.apache.org
For additional commands, e-mail: cvs-help@avalon.apache.org


Mime
View raw message