ptolemy.kernel.util

Interface LazyComposite

All Superinterfaces:

Configurable

All Known Implementing Classes:

AccessorLibrary, EntityLibrary, LazyTypedCompositeActor, ModularCodeGenLazyTypedCompositeActor, ModularCodeGenTypedCompositeActor, ModularCompiledSDFTypedCompositeActor

public interface LazyComposite
extends Configurable

A marker interface for lazy composites. A lazy composite is a CompositeEntity that does not automatically populate itself with contained entities and relations when it is instantiated. It does populate itself with attributes and ports, but the contained entities and relations are not created until they are explicitly requested.

Note that a class that implements this interface cannot have parameters whose values are expressions that refer to contained entities or relations or attributes contained by those. This is a rather esoteric use of expressions, so this limitation may not be onerous.

Since:

Ptolemy II 8.0

Version:

$Id$

Author:

Edward A. Lee, Christopher Hylands

See Also:

NamedObj, RecorderListener

Pt.AcceptedRating:

Green (cxh)

Pt.ProposedRating:

Green (eal)

Method Summary

Modifier and Type	Method and Description
void	populate() Populate the actor by reading the file specified by the source parameter.

Methods inherited from interface ptolemy.kernel.util.Configurable

configure, getConfigureSource, getConfigureText

Method Detail

populate

void populate()
       throws InvalidStateException

Populate the actor by reading the file specified by the source parameter. Note that the exception thrown here is a runtime exception, inappropriately. This is because execution of this method is deferred to the last possible moment, and it is often evaluated in a context where a compile-time exception cannot be thrown. Thus, extra care should be exercised to provide valid MoML specifications.

Throws:

InvalidStateException - If the source cannot be read, or if an exception is thrown parsing its MoML data.