MidgardBlob

typedef struct MidgardBlob MidgardBlob;

MidgardBlobClass

typedef struct MidgardBlobClass MidgardBlobClass;

MidgardBlobPrivate

typedef struct _MidgardBlobPrivate MidgardBlobPrivate;

midgard_blob_new ()

MidgardBlob*        midgard_blob_new                    (MgdObject *attachment);

Instatiate new Midgard Blob object for the given midgard_attachment object. This is almost the same constructor as g_object_new, but unlike that one, midgard_blob_new requires MgdObject (midgard_attachment) object's pointer.

This constructor defines new relative path for attachment, if midgard_attachment is associated with midgard_blob and its location is empty. In any other case, location is not changed.

midgard_blob_read_content ()

gchar*              midgard_blob_read_content           (MidgardBlob *self,
                                                         gsize *bytes_read);

Returned content should be freed when no longer needed. bytes_read holds size of returned content.

This function should be used to get content of small files. For large and huge ones midgard_blob_get_handler should be used to get file handle.

midgard_blob_write_content ()

gboolean            midgard_blob_write_content          (MidgardBlob *self,
                                                         const gchar *content);

Write given content to a file.

midgard_blob_get_handler ()

GIOChannel*         midgard_blob_get_handler            (MidgardBlob *self);

The main idea is to get file handler. On C level it returns GIOChannel, but language bindings could return typical file handler or anything else which is needed for particular language.

Returned channel is owned by midgard_blob and should not be freed or unreferenced.

midgard_blob_get_path ()

const gchar*        midgard_blob_get_path               (MidgardBlob *self);

Returned path is owned by midgard_blob and should not be freed. It basically contains blobdir and relative file's location.

midgard_blob_exists ()

gboolean            midgard_blob_exists                 (MidgardBlob *self);

Check if file associated with midgard_blob exists. This function will also return FALSE, if file is not yet associated.

midgard_blob_remove_file ()

gboolean            midgard_blob_remove_file            (MidgardBlob *self);

Deletes a file which is associated with blob and located at attachment's location which is initialized for blob. midgard_blob_exists should be invoked if file may be already deleted, for example when one file is shared among many attachments.