close

Filter

loading table of contents...

Studio Developer Manual / Version 2010

Table Of Contents

7.5.2.3 Listening to Metadata Availability/Changes

A metadata service is always associated with a specific preview panel. When a document is opened in a preview panel, it takes some time until its metadata is loaded. This happens asynchronously via the above mentioned message service. Consequently, it is necessary to have a mechanism to listen to the availability of a document's metadata. In addition, changes to the metadata may occur when the displayed document of the preview panel changes. Thus, it is also necessary to listen to metadata changes.

To this end, the method IMetadataService.getMetadataTree() is dependency-tracked. This means that it is possible to listen to changes to the returned metadata tree by using a function value expression (see com.coremedia.ui.data.dependencies.DependencyTracker and com.coremedia.ui.data.ValueExpressionFactory.createFromFunction). The following example is provided to illustrate this process:

var previewPnl:PreviewPanel = ... ;
ValueExpressionFactory.createFromFunction(
  function():MetadataTreeNode {
    var metadataTree:MetadataTree =
      previewPnl.getMetadataService().getMetadataTree();
    return metadataTree.getRoot() ? metadataTree : undefined;
  }
).loadValue(
  function(metadataTree:MetadataTree):void {
    // metadata tree loaded!
    metadataTree.getAsList()...;
  }
);

In this example MetadataTree.getRoot() is used as an indicator of whether the metadata has already been loaded (if not, the method returns null). A function value expression is created around a function that simply determines the existence of a metadata root node, returning undefined as long as it does not exist. Afterwards the value expression is loaded, which automatically retries to invoke the function until it returns a non undefined value. As soon as it does, the metadata has been loaded and the callback function can now process the metadata tree.

Search Results

Table Of Contents