Object: /org/woodchuck/object/ObjectUUID
Unregister this object. This does not remove any files, only metadata stored on the Woodchuck server is deleted.
This object is needed, e.g., the user just select an email to read.
This method is only useful for object’s that make use of Woodchuck’s simple transferer. See org.woodchuck.object.Versions for more information.
Parameters: | RequestType u (in) – The type of request.
|
---|
Indicate that an object has been transferred.
This is typically called in reaction to a org.woodchuck.upcall.ObjectTransfer() upcall, but should whenever an object is transferred.
The value of the object’s Instance property will be incremented by 1.
Parameters: |
|
---|
Parameters: |
|
---|
Call when an objects files have been removed or in response to org.woodchuck.upcall.ObjectDelete.
Parameters: |
|
---|
The stream this object belongs to.
The number of times this object has been transferred.
A human readable name.
Uninterpretted by Woodchuck. This is passed in any object upcalls.
The application can set this to a database key or URL to avoid having to manage a mapping between Woodchuck UUIDs and local identifiers.
An array of <URL, ExpectedSize, ExpectedTransferUp, ExpectedTransferDown, Utility, UseSimpleTransferer> tuples. Each tuple designates the same object, but with a different quality.
URL is optional. Its value is only interpretted by Woodchuck if UseSimpleTransferer is also true.
ExpectedSize is the expected amount of disk space required when this transfer completes. If this is negative, this indicates that transferring this objects frees space.
ExpectedTransferUp is the expected upload size, in bytes.
ExpectedTransferDown is the expected download size, in bytes.
Utility is the utility of this version of the object relative to other versions of this object. Woodchuck interprets the value linearly: a version with twice the utility is consider to offer twice the quality. If bandwidth is scarce but the object is considered to have a high utility, a lower quality version may be transferred. If a version has no utility, then it shouldn’t be listed here.
UseSimpleTransferer specifies whether to use Woodchuck’s built in simple transferer for transferring this object. When Woodchuck has transferred an object, it will invoke the org.woodchuck.upcall.ObjectTransferred() upcall.
If UseSimpleTransferer is false, Woodchuck will make the org.woodchuck.upcall.ObjectTransfer() upcall to the application when the application should transfer the object. Woodchuck also specified which version of the object to transfer.
Where to save the file(s). If FILENAME ends in a /, interpreted as a directory and the file is named after the URL.
Whether to wake the application when this job completes (i.e., by sending a dbus message) or to wait until a process subscribes to feedback (see org.woodchuck.manager.FeedbackSubscribe()). This is only meaningful if the Woodchuck server transfers the file (i.e., UseSimpleTransferer is true).
Approximately when the transfer should be performed, in seconds since the epoch. (If the property Period is not zero, automatically updated after each transfer.)
The special value 0 means at the next available opportunity.
The earliest time the transfer may occur. Seconds prior to TriggerTarget.
The latest time the transfer may occur. After this time, the transfer will be reported as having failed.
Seconds after TriggerTarget.
The period (in seconds) with which to repeat this transfer. Set to 0 to indicate that this is a one-shot transfer. This is useful for an object which is updated periodically, e.g., the weather report. You should not use this for a self-contained stream such as a blog. Instead, on transferring the feed, register each contained story as an individual object and mark it as transferred immediately. Default: 0.
Set to true if this object should not be transferred, e.g., because the application knows the user has no interest in it.
Set to true if an update for this object is available. This is automatically cleared by TransferStatus.
The priority, relative to other objects in the stream.
The time at which the object was discovered (in seconds since the epoch). This is normally the time at which the stream was updated.
The time at which the object was published (in seconds since the epoch).
The time at which the object was registered.
The time at which the object was last successfully transferred.
The time at which the last transfer attempt occured .
The status code of the last transfer attempt .