001: /*
002: * Copyright (c) 2001-2004 Caucho Technology, Inc. All rights reserved.
003: *
004: * The Apache Software License, Version 1.1
005: *
006: * Redistribution and use in source and binary forms, with or without
007: * modification, are permitted provided that the following conditions
008: * are met:
009: *
010: * 1. Redistributions of source code must retain the above copyright
011: * notice, this list of conditions and the following disclaimer.
012: *
013: * 2. Redistributions in binary form must reproduce the above copyright
014: * notice, this list of conditions and the following disclaimer in
015: * the documentation and/or other materials provided with the
016: * distribution.
017: *
018: * 3. The end-user documentation included with the redistribution, if
019: * any, must include the following acknowlegement:
020: * "This product includes software developed by the
021: * Caucho Technology (http://www.caucho.com/)."
022: * Alternately, this acknowlegement may appear in the software itself,
023: * if and wherever such third-party acknowlegements normally appear.
024: *
025: * 4. The names "Hessian", "Resin", and "Caucho" must not be used to
026: * endorse or promote products derived from this software without prior
027: * written permission. For written permission, please contact
028: * info@caucho.com.
029: *
030: * 5. Products derived from this software may not be called "Resin"
031: * nor may "Resin" appear in their names without prior written
032: * permission of Caucho Technology.
033: *
034: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
035: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
036: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
037: * DISCLAIMED. IN NO EVENT SHALL CAUCHO TECHNOLOGY OR ITS CONTRIBUTORS
038: * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
039: * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
040: * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
041: * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
042: * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
043: * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
044: * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
045: *
046: * @author Scott Ferguson
047: */
048:
049: package com.caucho.hessian.io;
050:
051: import java.io.IOException;
052: import java.io.OutputStream;
053: import java.lang.reflect.Field;
054: import java.lang.reflect.Method;
055: import java.lang.reflect.Modifier;
056:
057: /**
058: * Output stream for Hessian requests.
059: *
060: * <p>HessianOutput is unbuffered, so any client needs to provide
061: * its own buffering.
062: *
063: * <h3>Serialization</h3>
064: *
065: * <pre>
066: * OutputStream os = new FileOutputStream("test.xml");
067: * HessianOutput out = new HessianSerializerOutput(os);
068: *
069: * out.writeObject(obj);
070: * os.close();
071: * </pre>
072: *
073: * <h3>Writing an RPC Call</h3>
074: *
075: * <pre>
076: * OutputStream os = ...; // from http connection
077: * HessianOutput out = new HessianSerializerOutput(os);
078: * String value;
079: *
080: * out.startCall("hello"); // start hello call
081: * out.writeString("arg1"); // write a string argument
082: * out.completeCall(); // complete the call
083: * </pre>
084: */
085: public class HessianSerializerOutput extends HessianOutput {
086: /**
087: * Creates a new Hessian output stream, initialized with an
088: * underlying output stream.
089: *
090: * @param os the underlying output stream.
091: */
092: public HessianSerializerOutput(OutputStream os) {
093: super (os);
094: }
095:
096: /**
097: * Creates an uninitialized Hessian output stream.
098: */
099: public HessianSerializerOutput() {
100: }
101:
102: /**
103: * Applications which override this can do custom serialization.
104: *
105: * @param object the object to write.
106: */
107: public void writeObjectImpl(Object obj) throws IOException {
108: Class cl = obj.getClass();
109:
110: try {
111: Method method = cl.getMethod("writeReplace", new Class[0]);
112: Object repl = method.invoke(obj, new Object[0]);
113:
114: writeObject(repl);
115: return;
116: } catch (Exception e) {
117: }
118:
119: try {
120: writeMapBegin(cl.getName());
121: for (; cl != null; cl = cl.getSuperclass()) {
122: Field[] fields = cl.getDeclaredFields();
123: for (int i = 0; i < fields.length; i++) {
124: Field field = fields[i];
125:
126: if (Modifier.isTransient(field.getModifiers())
127: || Modifier.isStatic(field.getModifiers()))
128: continue;
129:
130: // XXX: could parameterize the handler to only deal with public
131: field.setAccessible(true);
132:
133: writeString(field.getName());
134: writeObject(field.get(obj));
135: }
136: }
137: writeMapEnd();
138: } catch (IllegalAccessException e) {
139: throw new IOExceptionWrapper(e);
140: }
141: }
142: }
|