Examples of ptolemy.kernel.util.NamedObj

ptolemy.kernel.util.NamedObj
This is a base class for almost all Ptolemy II objects.
This class supports a naming scheme, change requests, a persistent file format (MoML), a mutual exclusion mechanism for models (the workspace), an error handler, and a hierarchical class mechanism with inheritance.
An instance of this class can also be parameterized by attaching instances of the Attribute class. Instances of Attribute can be attached by calling their setContainer() method and passing this object as an argument. Those instances will then be reported by the {@link #getAttribute(String)}, {@link #getAttribute(String,Class)}, {@link #attributeList()}and {@link #attributeList(Class)} methods.Classes derived from NamedObj may constrain attributes to be a subclass of Attribute. To do that, they should override the protected {@link #_addAttribute(Attribute)} method to throw an exception ifthe object provided is not of the right class.
An instance of this class has a name. A name is an arbitrary string with no periods. If no name is provided, the name is taken to be an empty string (not a null reference). An instance also has a full name, which is a concatenation of the container's full name and the simple name, separated by a period. If there is no container, then the full name begins with a period. The full name is used for error reporting throughout Ptolemy II.
Instances of this class are associated with a workspace, specified as a constructor argument. The reference to the workspace is immutable. It cannot be changed during the lifetime of this object. It is used for synchronization of methods that depend on or modify the state of objects within it. If no workspace is specified, then the default workspace is used. Note that the workspace should not be confused with the container. The workspace never serves as a container.
In this base class, the container is null by default, and no method is provided to change it. Derived classes that support hierarchy provide one or more methods that set the container. By convention, if the container is set, then the instance should be removed from the workspace directory, if it is present. The workspace directory is expected to list only top-level objects in a hierarchy. The NamedObj can still use the workspace for synchronization. Any object contained by another uses the workspace of its container as its own workspace by default.
This class supports change requests or mutations, which are changes to a model that are performed in a disciplined fashion. In particular, a mutation can be requested via the {@link #requestChange(ChangeRequest)} method. By default, whena change is requested, the change is executed immediately. However, by calling {@link #setDeferringChangeRequests(boolean)}, you can ensure that change requests are queued to be executed only when it is safe to execute them.
This class supports the notion of a model error, which is an exception that is handled by a registered model error handler, or passed up the container hierarchy if there is no registered model error handler. This mechanism complements the exception mechanism in Java. Instead of unraveling the calling stack to handle exceptions, this mechanism passes control up the Ptolemy II hierarchy.
Derived classes should override the _description() method to append new fields if there is new information that should be included in the description. @author Mudit Goel, Edward A. Lee, Neil Smyth @version $Id: NamedObj.java,v 1.335 2007/12/07 06:24:44 cxh Exp $ @since Ptolemy II 0.2 @Pt.ProposedRating Green (eal) @Pt.AcceptedRating Green (cxh) @see Attribute @see Workspace

     *  @return A collection of settables that are also validated as a
     *  side effect, or null if there are none.
     *  @exception IllegalActionException If a error occurs
     */
    public Collection validate() throws IllegalActionException {
        NamedObj container = getContainer();


        if (container != null) {
            container.attributeChanged(this);
        }
        return null;
    }

View Full Code Here

    public JMenuItem create(final JContextMenu menu, NamedObj object) {
        String name = "Configure Arguments";


        // Removed this method since it was never used. EAL
        // final NamedObj target = _getItemTargetFromMenuTarget(object);
        final NamedObj target = object;


        // ensure that we actually have a target, and that it's an Entity.
        if (!(target instanceof GenericJNIActor)) {
            return null;
        }

View Full Code Here


                        // The context for the MoML should be the first
                        // container above this port in the hierarchy
                        // that defers its MoML definition, or the
                        // immediate parent if there is none.
                        NamedObj container = argument.getContainer();
                        String moml = "<deleteProperty name=\""
                                + argument.getName() + "\"/>\n";


                        ChangeRequest request = new MoMLChangeRequest(this,
                                container, moml);
                        container.addChangeListener(this);
                        container.requestChange(request);
                    }
                }
            }
        } else if (buttonPressed().equals("Help")) {
            help(configuration);

View Full Code Here

                        // request to the container, but this caused big
                        // problems... (weird null-pointer expections
                        // deep in diva when making connections).
                        // Is it sufficient to just go to the top level?
                        List changeListeners = new LinkedList();
                        NamedObj container = getContainer();


                        while (container != null) {
                            List list = container.getChangeListeners();


                            if (list != null) {
                                changeListeners.addAll(list);
                            }


                            container = container.getContainer();
                        }


                        change.setListeners(changeListeners);


                        change.execute();

View Full Code Here

    public static synchronized RecordToken executeModel(URL url,
            RecordToken args, String[] resultLabels)
            throws IllegalActionException {
        if (url != null) {
            MoMLParser parser = new MoMLParser();
            NamedObj model;


            try {
                model = parser.parse(null, url);
            } catch (Exception ex) {
                throw new IllegalActionException(ex

View Full Code Here

     *  @exception NameDuplicationException If the container already has
     *   a port with the name of this port.
     */
    public void setContainer(Entity container) throws IllegalActionException,
            NameDuplicationException {
        NamedObj oldContainer = getContainer();


        if (container == oldContainer) {
            // Nothing to do.
            return;
        }


        boolean disableStatus = _mirrorDisable;


        try {
            _workspace.getWriteAccess();


            if (_mirrorDisable || (getContainer() == null)) {
                // Have already called the super class.
                // This time, process the request.
                super.setContainer(container);
            } else {
                _mirrorDisable = true;


                boolean success = false;


                if (oldContainer != null) {
                    Nameable modal = oldContainer.getContainer();


                    if (modal instanceof MultiCompositeActor) {
                        Port port = ((MultiCompositeActor) modal)
                                .getPort(getName());

View Full Code Here

        }


        MoMLParser parser = ParserAttribute.getParser(this);
        parser.reset();


        NamedObj library = parser.parse(value());


        if (!(library instanceof CompositeEntity)) {
            throw new IllegalActionException(this,
                    "Expected library to be in an instance of CompositeEntity,"
                            + " but it is: " + library.getClass().getName());
        }


        // Ensure that the library is marked as a library.
        Attribute marker = library.getAttribute("_libraryMarker");


        if (marker == null) {
            new SingletonAttribute(library, "_libraryMarker");
        }

View Full Code Here


                    arguments[0] = this;
                    arguments[1] = "p2p_" + clsName.substring(l + 1);


                    try {
                        NamedObj newEntity = _createInstance(cls, arguments);
                        System.out.println("create an instance of " + clsName
                                + ".\n");
                        ((ComponentEntity) newEntity).setContainer(null);


                        String chg = newEntity.exportMoML();
                        System.out.println("the moml description of the "
                                + "new object is: \n" + chg + "\n");


                        ChangeRequest request = new MoMLChangeRequest(this, // originator
                                this, // context

View Full Code Here

            }


            if (match) {
                System.out.println("find a matched constructor.");


                NamedObj obj = (NamedObj) constructor.newInstance(arguments);
                System.out.println("construct a new actor instance.");
                return obj;
            }
        }

View Full Code Here

                return;
            }


            ExecEvent event = (ExecEvent) debugEvent;
            final ExecEvent.ExecEventType state = event.getState();
            NamedObj actor = event.getSource();


            // Get the corresponding graph node and its figure
            Object node = _nodeMap.get(actor);
            LabelWrapper wrapper = (LabelWrapper) _graphPane
                    .getGraphController().getFigure(node);

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of ptolemy.kernel.util.NamedObj

fr.soleil.bossanova.configuration.ActorRepository

ptolemy.actor.Director

ptolemy.actor.gt.ActorScopeExtender

ptolemy.actor.gt.GraphAnalyzer

ptolemy.actor.gt.GraphMatcher

ptolemy.actor.gt.GraphTransformer

ptolemy.actor.gt.NamedObjToken

ptolemy.actor.gui.Configuration

ptolemy.actor.gui.ModelFrame

ptolemy.actor.gui.MoMLApplication

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.