001: /*
002: * Copyright 1996-2000 Sun Microsystems, Inc. All Rights Reserved.
003: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
004: *
005: * This code is free software; you can redistribute it and/or modify it
006: * under the terms of the GNU General Public License version 2 only, as
007: * published by the Free Software Foundation. Sun designates this
008: * particular file as subject to the "Classpath" exception as provided
009: * by Sun in the LICENSE file that accompanied this code.
010: *
011: * This code is distributed in the hope that it will be useful, but WITHOUT
012: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
013: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
014: * version 2 for more details (a copy is included in the LICENSE file that
015: * accompanied this code).
016: *
017: * You should have received a copy of the GNU General Public License version
018: * 2 along with this work; if not, write to the Free Software Foundation,
019: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
020: *
021: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
022: * CA 95054 USA or visit www.sun.com if you need additional information or
023: * have any questions.
024: */
025: package sun.rmi.transport.proxy;
026:
027: import java.io.*;
028: import java.net.Socket;
029: import java.net.InetAddress;
030:
031: /**
032: * The HttpReceiveSocket class extends the WrappedSocket class
033: * by removing the HTTP protocol packaging from the input stream and
034: * formatting the output stream as an HTTP response.
035: *
036: * NOTES:
037: *
038: * The output stream must be explicitly closed for the output to be
039: * sent, since the HttpResponseOutputStream needs to buffer the entire
040: * transmission to be able to fill in the content-length field of
041: * the HTTP header. Closing this socket will do this.
042: *
043: * The constructor blocks until the HTTP protocol header
044: * is received. This could be fixed, but I don't think it should be a
045: * problem because this object would not be created unless the
046: * HttpAwareServerSocket has detected the beginning of the header
047: * anyway, so the rest should be there.
048: *
049: * This socket can only be used to process one POST and reply to it.
050: * Another message would be received on a newly accepted socket anyway.
051: */
052: public class HttpReceiveSocket extends WrappedSocket implements
053: RMISocketInfo {
054:
055: /** true if the HTTP header has pushed through the output stream yet */
056: private boolean headerSent = false;
057:
058: /**
059: * Layer on top of a pre-existing Socket object, and use specified
060: * input and output streams.
061: * @param socket the pre-existing socket to use
062: * @param in the InputStream to use for this socket (can be null)
063: * @param out the OutputStream to use for this socket (can be null)
064: */
065: public HttpReceiveSocket(Socket socket, InputStream in,
066: OutputStream out) throws IOException {
067: super (socket, in, out);
068:
069: this .in = new HttpInputStream(in != null ? in : socket
070: .getInputStream());
071: this .out = (out != null ? out : socket.getOutputStream());
072: }
073:
074: /**
075: * Indicate that this socket is not reusable.
076: */
077: public boolean isReusable() {
078: return false;
079: }
080:
081: /**
082: * Get the address to which this socket is connected. "null" is always
083: * returned (to indicate an unknown address) because the originating
084: * host's IP address cannot be reliably determined: both because the
085: * request probably went through a proxy server, and because if it was
086: * delivered by a local forwarder (CGI script or servlet), we do NOT
087: * want it to appear as if the call is coming from the local host (in
088: * case the remote object makes access control decisions based on the
089: * "client host" of a remote call; see bugid 4399040).
090: */
091: public InetAddress getInetAddress() {
092: return null;
093: }
094:
095: /**
096: * Get an OutputStream for this socket.
097: */
098: public OutputStream getOutputStream() throws IOException {
099: if (!headerSent) { // could this be done in constructor??
100: DataOutputStream dos = new DataOutputStream(out);
101: dos.writeBytes("HTTP/1.0 200 OK\r\n");
102: dos.flush();
103: headerSent = true;
104: out = new HttpOutputStream(out);
105: }
106: return out;
107: }
108:
109: /**
110: * Close the socket.
111: */
112: public synchronized void close() throws IOException {
113: getOutputStream().close(); // make sure response is sent
114: socket.close();
115: }
116:
117: /**
118: * Return string representation of the socket.
119: */
120: public String toString() {
121: return "HttpReceive" + socket.toString();
122: }
123: }
|