org.apache.axiom.util.activation

Class DataSourceUtils

java.lang.Object

org.apache.axiom.util.activation.DataSourceUtils

public class DataSourceUtils
extends java.lang.Object

Contains utility methods to work with DataSource objects.

Constructor Summary

Constructors

Constructor and Description
DataSourceUtils()

Method Summary

Modifier and Type	Method and Description
static long	getSize(javax.activation.DataSource ds) Determine the size of the data represented by a DataSource object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DataSourceUtils

public DataSourceUtils()

Method Detail

getSize

public static long getSize(javax.activation.DataSource ds)

Determine the size of the data represented by a DataSource object. The method will try to determine the size without reading the data source. It will do so by looking for the SizeAwareDataSource interface. In addition, it supports some other well known data source implementations for which it is possible to get the size of the data without reading it.

As noted in the documentation of the SizeAwareDataSource, the returned value may be an estimation that is not 100% accurate, and code using this method must be prepared to receive more or less data from the data source.

Parameters:

ds - the data source

Returns:

(an estimation of) the size of the data or -1 if the size is unknown