public abstract class OtherAttributeOnDisk extends Attribute
An abstract class specializing Attribute
for
Other (OB or OW) attributes whose values are not memory resident.
Used as a base class for OtherByteAttributeOnDisk
and OtherWordAttributeOnDisk
.
Modifier and Type | Field and Description |
---|---|
protected long |
byteOffset |
protected boolean |
deleteFilesWhenNoLongerNeeded |
protected java.io.File |
file |
valueLength, valueMultiplicity
Constructor and Description |
---|
OtherAttributeOnDisk(AttributeTag t)
Construct an (empty) attribute.
|
OtherAttributeOnDisk(AttributeTag t,
long vl,
DicomInputStream i,
long byteOffset)
Read an attribute from an input stream.
|
OtherAttributeOnDisk(AttributeTag t,
java.lang.Long vl,
DicomInputStream i,
java.lang.Long byteOffset)
Read an attribute from an input stream.
|
Modifier and Type | Method and Description |
---|---|
void |
deleteFilesWhenNoLongerNeeded() |
protected void |
finalize() |
long |
getByteOffset() |
java.io.File |
getFile() |
void |
removeValues()
Remove any existing values, making the attribute empty (zero length).
|
void |
setFile(java.io.File file)
Change the file containing the data, for example if it has been renamed.
|
void |
setFile(java.io.File file,
long byteOffset)
Change the file containing the data, for example if it is a new, perhaps temporary, file containing only pixel data.
|
java.lang.String |
toString(DicomDictionary dictionary)
Dump the contents of the attribute as a human-readable string.
|
addValue, addValue, addValue, addValue, addValue, addValue, addValue, getByteValues, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDoubleValues, getDoubleValues, getDoubleValues, getElement, getFloatValues, getFloatValues, getFloatValues, getGroup, getIntegerValues, getIntegerValues, getIntegerValues, getLongValues, getLongValues, getLongValues, getOriginalStringValues, getPaddedVL, getShortValues, getSingleDoubleValueOrDefault, getSingleDoubleValueOrDefault, getSingleDoubleValueOrDefault, getSingleFloatValueOrDefault, getSingleFloatValueOrDefault, getSingleFloatValueOrDefault, getSingleIntegerValueOrDefault, getSingleIntegerValueOrDefault, getSingleIntegerValueOrDefault, getSingleLongValueOrDefault, getSingleLongValueOrDefault, getSingleLongValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getStringValues, getStringValues, getStringValues, getStringValues, getStringValues, getStringValues, getTag, getVL, getVM, getVR, getVRAsString, isValid, repairValues, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValues, setValues, setValues, setValues, toString, write, writeBase
protected long byteOffset
protected java.io.File file
protected boolean deleteFilesWhenNoLongerNeeded
public OtherAttributeOnDisk(AttributeTag t)
Construct an (empty) attribute.
t
- the tag of the attributepublic OtherAttributeOnDisk(AttributeTag t, long vl, DicomInputStream i, long byteOffset) throws java.io.IOException, DicomException
Read an attribute from an input stream.
t
- the tag of the attributevl
- the value length of the attributei
- the input streambyteOffset
- the byte offset in the input stream of the start of the datajava.io.IOException
- if an I/O error occursDicomException
- if error in DICOM encodingpublic OtherAttributeOnDisk(AttributeTag t, java.lang.Long vl, DicomInputStream i, java.lang.Long byteOffset) throws java.io.IOException, DicomException
Read an attribute from an input stream.
t
- the tag of the attributevl
- the value length of the attributei
- the input streambyteOffset
- the byte offset in the input stream of the start of the datajava.io.IOException
- if an I/O error occursDicomException
- if error in DICOM encodingpublic java.lang.String toString(DicomDictionary dictionary)
Attribute
Dump the contents of the attribute as a human-readable string.
No new line is appended.
The result is of the form:
(0xgggg,0xeeee) Name VR=<XX> VL=<0xnnnn> <...>
For example:
(0x0018,0x0020) ScanningSequence VR=<CS> VL=<0x2> <GR>
public long getByteOffset()
public java.io.File getFile()
public void setFile(java.io.File file)
Change the file containing the data, for example if it has been renamed.
The existing byteOffset value is unchanged.
file
- the new file containing the datapublic void setFile(java.io.File file, long byteOffset) throws java.io.IOException
Change the file containing the data, for example if it is a new, perhaps temporary, file containing only pixel data.
The value length is set to the length of the file minus the byteOffset.
file
- the new file containing the databyteOffset
- the byte offset in the input stream of the start of the datajava.io.IOException
- if cannot obtain the length of the filepublic void removeValues()
Attribute
Remove any existing values, making the attribute empty (zero length).
removeValues
in class Attribute
public void deleteFilesWhenNoLongerNeeded()
protected void finalize() throws java.lang.Throwable
finalize
in class java.lang.Object
java.lang.Throwable