...
| Table of Contents | ||
|---|---|---|
|
...
The Content Repository in XperienCentral is used to store Images, downloads and Flash animations and custom media items. Access to these content items is exposed through the MediaRepositoryManagementService. The MediaRepositoryManagementService contains methods for creating and deleting items in the Content Repository. It also contains methods for coupling the actual file to the item that has been created in the Content Repository.
Creating an Image
...
or Download
...
To create an item for the Content Repository, use one of the three create methods. All of them take one argument: the name of the website for which the media item will be created. The following code example shows how to create an Image, Download or Flash:
| Code Block | ||
|---|---|---|
| ||
MediaItem image = myMediaRepositoryService.createImageMediaItem(mySession.getXperienCentralApplication().getWebsites()[0]);
MediaItem download = myMediaRepositoryService.createDownloadMediaItem(mySession.getXperienCentralApplication().getWebsites()[0]);
MediaItem flash = myMediaRepositoryService.createFlashMediaItem(mySession.getXperienCentralApplication().getWebsites()[0]);
|
...
Attaching a File to
...
an Image
...
or Download
...
After creating a content item, the actual file needs to be attached to it. The is done using the attachFile method, which takes a MultiPartFile as argument and only works on versions of the content items that can be created. To make this work, the follwing steps must be performed:
...
The following code example shows how to do so for an Image:
| Code Block | ||
|---|---|---|
| ||
// Create the media item
MediaItem image = myMediaRepositoryService.createImageMediaItem(mySession.getXperienCentralApplication().getWebsites()[0]);
// Create the version of the media item (in this example for an Image)
MediaItemImageVersion imageversion = null;
if (image.getCurrent() != null) {
imageversion = (MediaItemImageVersion) image.getCurrent();
} else {
imageversion = (MediaItemImageVersion) image.getPlanned();
}
// Create a MultiPartFile, based on a file on disk
fileToAttach = "C:\\temp\\image.jpg";
MultipartFile mpfile = null;
try {
File file = new File(fileToAttach);
InputStream inputstream = new FileInputStream(file);
try {
mpfile = new MockMultipartFile(fileToAttach, fileToAttach, "image/jpeg", inputstream);
} catch (IOException e) {
//Handle the exception
}
} catch (FileNotFoundException e) {
// Handle the exception
}
// Attach the MultiPartFile to the MediaItemImageVersion
if (mpfile != null) {
imageversion.attachFile(mpfile);
} |
In the example above, a MockMultipartFile is created to attach to the image media item. If the file to be attached is uploaded to XperienCentral by the editor, it will be available as MultipartFile directly using Spring binding on a file input field. The procedure for attaching a file to a Download (MediaItemDownloadVersion) or Flash (MediaItemFlashVersion) media item is identical.
...
Detaching a File from an Image
...
or Download
...
Detaching a file from a media item is handled by the detachFile method which has has no arguments. It works exactly the same for a MediaItemImageVersion, and MediaItemDownloadVersion and MediaItemFlashVersion. For example:
| Code Block | ||
|---|---|---|
| ||
MediaItemImageVersion imageversion = null; // Long piece of code that attaches a file to the imageversion object imageversion.detachFile(); |
...
Attaching a Backup Image to the Flash Content Item
The Flash media item also has the property of a backup image file. This image will be used that have problems showing the Flash file. The method attachBackupImage works exactly the same as the attachFile method as explained in the previously in this topic. For example:
| Code Block | ||
|---|---|---|
| ||
MediaItemFlashVersion flashversion = null;
// Long piece of code that creates a MultiPartFile containing the backup image
flashversion. attachBackupImage(mpfileOfTheBackupImage);
|