You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sc...@apache.org on 2002/12/22 20:55:30 UTC
cvs commit: jakarta-commons/lang/src/java/org/apache/commons/lang SerializationUtils.java
scolebourne 2002/12/22 11:55:30
Modified: lang/src/java/org/apache/commons/lang
SerializationUtils.java
Log:
Update for performance, from Jeff Varszegi
Revision Changes Path
1.4 +20 -9 jakarta-commons/lang/src/java/org/apache/commons/lang/SerializationUtils.java
Index: SerializationUtils.java
===================================================================
RCS file: /home/cvs/jakarta-commons/lang/src/java/org/apache/commons/lang/SerializationUtils.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- SerializationUtils.java 16 Nov 2002 10:41:03 -0000 1.3
+++ SerializationUtils.java 22 Dec 2002 19:55:30 -0000 1.4
@@ -1,5 +1,3 @@
-package org.apache.commons.lang;
-
/* ====================================================================
* The Apache Software License, Version 1.1
*
@@ -53,6 +51,7 @@
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/
+package org.apache.commons.lang;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
@@ -64,8 +63,8 @@
import java.io.Serializable;
/**
- * <p>Methods that assist with the serialization process, or perform
- * additional functionality based on serialization.</p>
+ * <p><code>SerializationUtils</code> provides methods that assist with the
+ * serialization process, or perform additional functionality based on serialization.</p>
* <ul>
* <li>Deep clone using serialization
* <li>Serialize managing finally and IOException
@@ -75,15 +74,21 @@
* @author <a href="mailto:nissim@nksystems.com">Nissim Karpenstein</a>
* @author <a href="mailto:janekdb@yahoo.co.uk">Janek Bogucki</a>
* @author <a href="mailto:dlr@finemaltcoding.com">Daniel Rall</a>
- * @author <a href="mailto:scolebourne@joda.org">Stephen Colebourne</a>
+ * @author Stephen Colebourne
+ * @author Jeff Varszegi
+ * @since 1.0
* @version $Id$
*/
public class SerializationUtils {
/**
- * <p>Constructor for SerializationUtils is private.</p>
+ * <p>SerializationUtils instances should NOT be constructed in standard programming.
+ * Instead, the class should be used as <code>SerializationUtils.clone(object)</code>.</p>
+ *
+ * <p>This constructor is public to permit tools that require a JavaBean instance
+ * to operate.</p>
*/
- private SerializationUtils() {
+ public SerializationUtils() {
super();
}
@@ -110,6 +115,9 @@
* <p>The stream will be closed once the object is written.
* This avoids the need for a finally clause, and maybe also exception
* handling, in the application code.</p>
+ *
+ * <p>The stream passed in is not buffered internally within this method.
+ * This is the responsibility of your application if desired.</p>
*
* @param obj the object to serialize to bytes
* @param outputStream the stream to write to
@@ -144,7 +152,7 @@
* @throws SerializationException (runtime) if the serialization fails
*/
public static byte[] serialize(Serializable obj) {
- ByteArrayOutputStream baos = new ByteArrayOutputStream();
+ ByteArrayOutputStream baos = new ByteArrayOutputStream(512);
serialize(obj, baos);
return baos.toByteArray();
}
@@ -155,6 +163,9 @@
* <p>The stream will be closed once the object is written. This
* avoids the need for a finally clause, and maybe also exception
* handling, in the application code.</p>
+ *
+ * <p>The stream passed in is not buffered internally within this method.
+ * This is the responsibility of your application if desired.</p>
*
* @param inputStream the serialized object input stream
* @return the deserialized object
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>