ISObject (Java Tool 1.26.2 API)

All Superinterfaces:

Serializable

All Known Implementing Classes:

SObject, SObject.ByteArraySObject, SObject.FileSObject, SObject.InputStreamSObject, SObject.LazyLoadSObject, SObject.StringSObject
```
public interface ISObject
extends Serializable
```
Represent an item stored in an IStorageService

Author:

greenl

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ATTR_CONTENT_LENGTH` Store the content length
`static String`	`ATTR_CONTENT_TYPE` A standard attribute: content-type
`static String`	`ATTR_FILE_NAME` A standard attribute: filename
`static String`	`ATTR_SS_CTX` The storage service context path
`static String`	`ATTR_SS_ID` The storage service ID
`static String`	`ATTR_URL` Store the URL point to this sobject
`static osgl.version.Version`	`VERSION`

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`byte[]`	`asByteArray()`
`File`	`asFile()`
`InputStream`	`asInputStream()` Returns an `InputStream` connect to the sobject.
`String`	`asString()`
`String`	`asString(Charset charset)`
`void`	`consumeOnce(Lang.Function<InputStream,?> consumer)` Consume the inputstream of this storage object one time and then close the input stream
`String`	`getAttribute(String key)` Return attribute associated with this storage object by key.
`Map<String,String>`	`getAttributes()`
`String`	`getContentType()` Return `content type` attribute
`Throwable`	`getException()` Return previous exception that cause the sobject invalid
`String`	`getFilename()` Returns `filename` attribute
`String`	`getKey()`
`long`	`getLength()`
`String`	`getUrl()` Returns URL set to this SObject.
`boolean`	`hasAttribute()`
`boolean`	`isAccessDenied()` Is access to the resource represented by this sobject denied.
`boolean`	`isBinary()` Probe if the storage object is binary or text
`boolean`	`isDumb()` Returns `true` if this SObject is dumb
`boolean`	`isEmpty()` Is content is empty
`boolean`	`isExists()` Is the resource exists.
`boolean`	`isValid()` Is this storage object valid.
`ISObject`	`setAttribute(String key, String val)` Set an attribute to the storage object associated by key specified.
`ISObject`	`setAttributes(Map<String,String> attrs)` Set attributes to the storage object
`void`	`setContentType(String contentType)` Set `content type` attribute
`void`	`setFilename(String filename)` Set `filename` attribute

- Field Detail
  - VERSION
```
static final osgl.version.Version VERSION
```
  - ATTR_CONTENT_TYPE
```
static final String ATTR_CONTENT_TYPE
```
    A standard attribute: content-type
    
    See Also:
    
    Constant Field Values
  - ATTR_FILE_NAME
```
static final String ATTR_FILE_NAME
```
    A standard attribute: filename
    
    See Also:
    
    Constant Field Values
  - ATTR_SS_ID
```
static final String ATTR_SS_ID
```
    The storage service ID
    
    See Also:
    
    Constant Field Values
  - ATTR_SS_CTX
```
static final String ATTR_SS_CTX
```
    The storage service context path
    
    See Also:
    
    Constant Field Values
  - ATTR_URL
```
static final String ATTR_URL
```
    Store the URL point to this sobject
    
    See Also:
    
    Constant Field Values
  - ATTR_CONTENT_LENGTH
```
static final String ATTR_CONTENT_LENGTH
```
    Store the content length
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getKey
```
String getKey()
```
    Returns:
    
    key of this object
  - getLength
```
long getLength()
```
    Returns:
    
    length of the object
  - getUrl
```
String getUrl()
```
    Returns URL set to this SObject.
    
    Calling to this method shall have the same result as calling getAttribute(String) using ATTR_URL:
```
    String url = sobj.getAttribute(ISObject.ATTR_URL);
```
    Returns:
    
    the url to this SObject
  - getFilename
```
String getFilename()
```
    Returns filename attribute
    
    Returns:
    
    filename
  - getContentType
```
String getContentType()
```
    Return content type attribute
    
    Returns:
    
    content type
  - setFilename
```
void setFilename(String filename)
```
    Set filename attribute
    
    Parameters:
    
    filename - the filename to be set
  - setContentType
```
void setContentType(String contentType)
```
    Set content type attribute
    
    Parameters:
    
    contentType - the content type to be set
  - getAttribute
```
String getAttribute(String key)
```
    Return attribute associated with this storage object by key. If there is no such attribute found then null is returned
    
    Returns:
    
    the attribute if found or null if not found
  - setAttribute
```
ISObject setAttribute(String key,
                      String val)
```
    Set an attribute to the storage object associated by key specified.
    
    Parameters:
    
    key - attribute key
    
    val - attribute value
  - setAttributes
```
ISObject setAttributes(Map<String,String> attrs)
```
    Set attributes to the storage object
    
    Parameters:
    
    attrs -
    
    Returns:
    
    the object with attributes set
  - hasAttribute
```
boolean hasAttribute()
```
    Returns:
    
    true if the storage object has attributes
  - getAttributes
```
Map<String,String> getAttributes()
```
    Returns:
    
    a copy of attributes of this storage object
  - isEmpty
```
boolean isEmpty()
```
    Is content is empty
    
    Returns:
    
    true if the sobject is empty, false otherwise
  - isExists
```
boolean isExists()
```
    Is the resource exists.
    
    Note if this method returns true then isValid() must return false.
    
    Returns:
    
    true if the resource back this sobject exists, false otherwise
  - isValid
```
boolean isValid()
```
    Is this storage object valid. A storage object is not valid if the file/input stream is not readable
    
    Returns:
    
    true if this sobject is valid or false otherwise
  - isAccessDenied
```
boolean isAccessDenied()
```
    Is access to the resource represented by this sobject denied.
    
    Note if this method returns true then isValid() must returnfalse`
    
    Returns:
    
    true if access to the resource back this sobject denied, false otherwise.
  - getException
```
Throwable getException()
```
    Return previous exception that cause the sobject invalid
    
    Returns:
    
    the previous exception
  - asFile
```
File asFile()
     throws UnexpectedIOException
```
    Returns:
    
    the the stuff content as an file
    
    Throws:
    
    UnexpectedIOException
  - asString
```
String asString()
         throws UnexpectedIOException
```
    Returns:
    
    the stuff content as a string
    
    Throws:
    
    UnexpectedIOException
  - asString
```
String asString(Charset charset)
         throws UnexpectedIOException
```
    Returns:
    
    the stuff content as a string using the charset to encode
    
    Throws:
    
    UnexpectedIOException
  - asByteArray
```
byte[] asByteArray()
            throws UnexpectedIOException
```
    Returns:
    
    the stuff content as a byte array
    
    Throws:
    
    UnexpectedIOException
  - asInputStream
```
InputStream asInputStream()
                   throws UnexpectedIOException
```
    Returns an InputStream connect to the sobject. Note it is caller’s responsibility to close the inputStream
    
    Returns:
    
    the stuff content as an input stream
    
    Throws:
    
    UnexpectedIOException
  - consumeOnce
```
void consumeOnce(Lang.Function<InputStream,?> consumer)
          throws UnexpectedIOException
```
    Consume the inputstream of this storage object one time and then close the input stream
    
    Parameters:
    
    consumer - the consumer function
    
    Throws:
    
    UnexpectedIOException
  - isDumb
```
boolean isDumb()
```
    Returns true if this SObject is dumb
    
    Returns:
    
    true if this instance is dumb
  - isBinary
```
boolean isBinary()
```
    Probe if the storage object is binary or text
    
    Returns:
    
    true if the storage object is binary, false otherwise

Interface ISObject

Field Summary

Method Summary

Field Detail

VERSION

ATTR_CONTENT_TYPE

ATTR_FILE_NAME

ATTR_SS_ID

ATTR_SS_CTX

ATTR_URL

ATTR_CONTENT_LENGTH

Method Detail

getKey

getLength

getUrl

getFilename

getContentType

setFilename

setContentType

getAttribute

setAttribute

setAttributes

hasAttribute

getAttributes

isEmpty

isExists

isValid

isAccessDenied

getException

asFile

asString

asString

asByteArray

asInputStream

consumeOnce

isDumb

isBinary