java.lang.Object
- org.apache.axis.attachments.ManagedMemoryDataSource

All Implemented Interfaces:

javax.activation.DataSource
```
public class ManagedMemoryDataSource
extends java.lang.Object
implements javax.activation.DataSource
```
This class allows small attachments to be cached in memory, while large ones are cached out. It implements a Java Activiation Data source interface.

Author:

Rick Rineholt

Field Summary

Fields
Modifier and Type	Field	Description
`protected java.io.BufferedOutputStream`	`cachediskstream`	This is the cached disk stream.
`protected boolean`	`closed`	If true the source input stream is now closed.
`protected java.lang.String`	`contentType`	The content type.
`protected byte[]`	`currentMemoryBuf`	Hold the last memory buffer.
`protected int`	`currentMemoryBufSz`	The number of bytes written to the above buffer.
`protected boolean`	`debugEnabled`	Field debugEnabled
`protected boolean`	`deleted`	Flag to show if the resources behind this have been deleted.
`protected java.io.File`	`diskCacheFile`	Field diskCacheFile
`protected static org.apache.commons.logging.Log`	`is_log`	Field is_log
`protected static org.apache.commons.logging.Log`	`log`	Field log
`static int`	`MAX_MEMORY_DISK_CACHED`	Field MAX_MEMORY_DISK_CACHED
`protected int`	`maxCached`	Field maxCached
`protected java.util.LinkedList`	`memorybuflist`	The linked list to hold the in memory buffers.
`static int`	`MIN_MEMORY_DISK_CACHED`	Field MIN_MEMORY_DISK_CACHED
`static int`	`READ_CHUNK_SZ`	Field READ_CHUNK_SZ
`protected java.util.WeakHashMap`	`readers`	Field readers
`protected long`	`totalsz`	The total size in bytes in this data source.

Constructor Summary

Constructors
Modifier	Constructor	Description
`protected`	`ManagedMemoryDataSource()`	Constructor ManagedMemoryDataSource.
	`ManagedMemoryDataSource(java.io.InputStream ss, int maxCached, java.lang.String contentType)`	Create a new boundary stream.
	`ManagedMemoryDataSource(java.io.InputStream ss, int maxCached, java.lang.String contentType, boolean readall)`	Create a new boundary stream.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`protected void`	`close()`	This method is a low level write.
`boolean`	`delete()`
`protected void`	`finalize()`
`protected void`	`flushToDisk()`	Routine to flush data to disk if is in memory.
`java.lang.String`	`getContentType()`	This method returns the MIME type of the data in the form of a string.
`java.io.File`	`getDiskCacheFile()`	get the filename of the content if it is cached to disk.
`java.io.InputStream`	`getInputStream()`	This method returns an InputStream representing the the data and throws the appropriate exception if it can not do so.
`java.lang.String`	`getName()`	This will flush any memory source to disk and provide the name of the file if desired.
`java.io.OutputStream`	`getOutputStream()`	This method returns an OutputStream where the data can be written and throws the appropriate exception if it can not do so.
`static void`	`main(java.lang.String[] arg)`	Method main
`protected void`	`write(byte[] data)`	Write bytes to the stream.
`protected void`	`write(byte[] data, int length)`	This method is a low level write.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - log
```
protected static org.apache.commons.logging.Log log
```
    Field log
  - contentType
```
protected java.lang.String contentType
```
    The content type. This defaults to application/octet-stream.
  - MIN_MEMORY_DISK_CACHED
```
public static final int MIN_MEMORY_DISK_CACHED
```
    Field MIN_MEMORY_DISK_CACHED
    
    See Also:
    
    Constant Field Values
  - MAX_MEMORY_DISK_CACHED
```
public static final int MAX_MEMORY_DISK_CACHED
```
    Field MAX_MEMORY_DISK_CACHED
    
    See Also:
    
    Constant Field Values
  - maxCached
```
protected int maxCached
```
    Field maxCached
  - diskCacheFile
```
protected java.io.File diskCacheFile
```
    Field diskCacheFile
  - readers
```
protected java.util.WeakHashMap readers
```
    Field readers
  - deleted
```
protected boolean deleted
```
    Flag to show if the resources behind this have been deleted.
  - READ_CHUNK_SZ
```
public static final int READ_CHUNK_SZ
```
    Field READ_CHUNK_SZ
    
    See Also:
    
    Constant Field Values
  - debugEnabled
```
protected boolean debugEnabled
```
    Field debugEnabled
  - memorybuflist
```
protected java.util.LinkedList memorybuflist
```
    The linked list to hold the in memory buffers.
  - currentMemoryBuf
```
protected byte[] currentMemoryBuf
```
    Hold the last memory buffer.
  - currentMemoryBufSz
```
protected int currentMemoryBufSz
```
    The number of bytes written to the above buffer.
  - totalsz
```
protected long totalsz
```
    The total size in bytes in this data source.
  - cachediskstream
```
protected java.io.BufferedOutputStream cachediskstream
```
    This is the cached disk stream.
  - closed
```
protected boolean closed
```
    If true the source input stream is now closed.
  - is_log
```
protected static org.apache.commons.logging.Log is_log
```
    Field is_log
- Constructor Detail
  - ManagedMemoryDataSource
```
protected ManagedMemoryDataSource()
```
    Constructor ManagedMemoryDataSource.
  - ManagedMemoryDataSource
```
public ManagedMemoryDataSource(java.io.InputStream ss,
                               int maxCached,
                               java.lang.String contentType)
                        throws java.io.IOException
```
    Create a new boundary stream.
    
    Parameters:
    
    ss - is the source input stream that is used to create this data source.
    
    maxCached - This is the max memory that is to be used to cache the data.
    
    contentType - the mime type for this data stream. by buffering you can some effiency in searching.
    
    Throws:
    
    java.io.IOException
  - ManagedMemoryDataSource
```
public ManagedMemoryDataSource(java.io.InputStream ss,
                               int maxCached,
                               java.lang.String contentType,
                               boolean readall)
                        throws java.io.IOException
```
    Create a new boundary stream.
    
    Parameters:
    
    ss - is the source input stream that is used to create this data source.
    
    maxCached - This is the max memory that is to be used to cache the data.
    
    contentType - the mime type for this data stream. by buffering you can some effiency in searching.
    
    readall - if true will read in the whole source.
    
    Throws:
    
    java.io.IOException
- Method Detail
  - getContentType
```
public java.lang.String getContentType()
```
    This method returns the MIME type of the data in the form of a string.
    
    Specified by:
    
    getContentType in interface javax.activation.DataSource
    
    Returns:
    
    The mime type.
  - getInputStream
```
public java.io.InputStream getInputStream()
                                   throws java.io.IOException
```
    This method returns an InputStream representing the the data and throws the appropriate exception if it can not do so.
    
    Specified by:
    
    getInputStream in interface javax.activation.DataSource
    
    Returns:
    
    the java.io.InputStream for the data source.
    
    Throws:
    
    java.io.IOException
  - getName
```
public java.lang.String getName()
```
    This will flush any memory source to disk and provide the name of the file if desired.
    
    Specified by:
    
    getName in interface javax.activation.DataSource
    
    Returns:
    
    the name of the file of the stream
  - getOutputStream
```
public java.io.OutputStream getOutputStream()
                                     throws java.io.IOException
```
    This method returns an OutputStream where the data can be written and throws the appropriate exception if it can not do so. NOT SUPPORTED, not need for axis, data sources are create by constructors.
    
    Specified by:
    
    getOutputStream in interface javax.activation.DataSource
    
    Returns:
    
    always null
    
    Throws:
    
    java.io.IOException
  - write
```
protected void write(byte[] data)
              throws java.io.IOException
```
    Write bytes to the stream.
    
    Parameters:
    
    data - all bytes of this array are written to the stream
    
    Throws:
    
    java.io.IOException - if there was a problem writing the data
  - write
```
protected void write(byte[] data,
                     int length)
              throws java.io.IOException
```
    This method is a low level write. Note it is designed to in the future to allow streaming to both memory AND to disk simultaneously.
    
    Parameters:
    
    data -
    
    length -
    
    Throws:
    
    java.io.IOException
  - close
```
protected void close()
              throws java.io.IOException
```
    This method is a low level write. Close the stream.
    
    Throws:
    
    java.io.IOException
  - finalize
```
protected void finalize()
                 throws java.lang.Throwable
```
    Overrides:
    
    finalize in class java.lang.Object
    
    Throws:
    
    java.lang.Throwable
  - flushToDisk
```
protected void flushToDisk()
                    throws java.io.IOException,
                           java.io.FileNotFoundException
```
    Routine to flush data to disk if is in memory.
    
    Throws:
    
    java.io.IOException
    
    java.io.FileNotFoundException
  - delete
```
public boolean delete()
```
  - main
```
public static void main(java.lang.String[] arg)
```
    Method main
    
    Parameters:
    
    arg -
  - getDiskCacheFile
```
public java.io.File getDiskCacheFile()
```
    get the filename of the content if it is cached to disk.
    
    Returns:
    
    file object pointing to file, or null for memory-stored content

Class ManagedMemoryDataSource

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

log

contentType

MIN_MEMORY_DISK_CACHED

MAX_MEMORY_DISK_CACHED

maxCached

diskCacheFile

readers

deleted

READ_CHUNK_SZ

debugEnabled

memorybuflist

currentMemoryBuf

currentMemoryBufSz

totalsz

cachediskstream

closed

is_log

Constructor Detail

ManagedMemoryDataSource

ManagedMemoryDataSource

ManagedMemoryDataSource

Method Detail

getContentType

getInputStream

getName

getOutputStream

write

write

close

finalize

flushToDisk

delete

main

getDiskCacheFile