Examples of ptolemy.moml.MoMLParser$UnlinkRequest

ptolemy.moml.MoMLParser
This class constructs Ptolemy II models from specifications in MoML (modeling markup language), which is based on XML. The class contains an instance of the Microstar Ælfred XML parser and implements callback methods to interpret the parsed XML. The way to use this class is to call its parse() method. The returned value is top-level composite entity of the model.
For convenience, there are several forms of the parse method. Most of these take two arguments, a base, and some specification of the MoML to parse (a stream or the text itself). The base is used to interpret relative URLs that might be present in the MoML. For example, the base might be the document base of an applet. An applet might use this class as follows:
```
 MoMLParser parser = new MoMLParser(); URL docBase = getDocumentBase(); URL xmlFile = new URL(docBase, modelURL); NamedObj toplevel = parser.parse(docBase, xmlFile); 
```
If the first argument to parse() is null, then it is assumed that all URLs in the MoML file are absolute.
It can be difficult to create an appropriate URL to give as a base, particularly if what you have is a file or file name in the directory that you want to use as a base. The easiest technique is to use the toURL() method of the File class. Some of the URL constructors, for reasons we don't understand, create URLs that do not work.
The MoML code given to a parse() method may be a fragment, and does not need to include the "<?xml ... >" element nor the DOCTYPE specification. However, if the DOCTYPE specification is not given, then the DTD will not be read. The main consequence of this, given the parser we are using, is that default values for attributes will not be set. This could cause errors. The parser itself is not a validating parser, however, so it makes very limited use of the DTD. This may change in the future, so it is best to give the DOCTYPE element.
The parse() methods can be used for incremental parsing. After creating an initial model using a call to parse(), further MoML fragments without top-level entity or derived objects can be evaluated to modify the model. You can specify the context in which the MoML to be interpreted by calling setContext(). However, the XML parser limits each fragment to one element. So there always has to be one top-level element. If you wish to evaluate a group of MoML elements in some context, set the context and then place your MoML elements within a group element, as follows:
```
 <group> ... sequence of MoML elements ... </group> 
```
The group element is ignored, and just serves to aggregate the MoML elements, unless it has a name attribute. If it has a name attribute, then the name becomes a prefix (separated by a colon) of all the names of items immediately in the group element. If the value of the name attribute is "auto", then the group is treated specially. Each item immediately contained by the group (i.e. not deeply contained) will be created with its specified name or a modified version of that name that does not match a pre-existing object already contained by the container. That is, when name="auto" is specified, each item is forced to be created with unique name, rather than possibly matching a pre-existing item.
The parse methods throw a variety of exceptions if the parsed data does not represent a valid MoML file or if the stream cannot be read for some reason.
This parser supports the way Ptolemy II handles hierarchical models, where components are instances cloned from reference models called "classes." A model (a composite entity) is a "class" in Ptolemy II if the elementName field of its MoMLInfo object is the string "class". If a component is cloned from a class, then when that component exports MoML, it references the class from which it was cloned and exports only differences from that class. I.e., if further changes are made to the component, it is important that when the component exports MoML, that those changes are represented in the exported MoML. This effectively implements an inheritance mechanism, where a component inherits all the features of the master from which it is cloned, but then extends the model with its own changes.
This class always processes MoML commands in the following order within a "class" or "entity" element, irrespective of the order in which they appear:
1. Create properties, entities, ports and relations; and
2. Create links.
Within each category, the order of actions depends on the order in which the commands appear in the MoML text.
This class works closely with MoMLChangeRequest to implement another feature of Ptolemy II hierarchy. In particular, if an entity is cloned from another that identifies itself as a "class", then any changes that are made to the class via a MoMLChangeRequest are also made to the clone. This parser ensures that those changes are not exported when MoML is exported by the clone, because they will be exported when the master exports MoML. @see MoMLChangeRequest @author Edward A. Lee, Steve Neuendorffer, John Reekie, Contributor: Christopher Hylands @version $Id: MoMLParser.java,v 1.343 2007/12/07 06:28:36 cxh Exp $ @since Ptolemy II 0.4 @Pt.ProposedRating Red (eal) @Pt.AcceptedRating Red (johnr)

            // Ignore blank argument.
        } else {
            if (_expectingClass) {
                _expectingClass = false;


                MoMLParser parser = new MoMLParser();
                String string = "<entity name=\"toplevel\" class=\"" + arg
                        + "\"/>";
                CompositeActor model = (CompositeActor) parser.parse(string);


                // Temporary hack because cloning doesn't properly clone
                // type constraints.
                CompositeActor modelClass = (CompositeActor) parser
                        .searchForClass(arg, model.getSource());


                if (modelClass != null) {
                    model = modelClass;
                }

View Full Code Here

    ///////////////////////////////////////////////////////////////////
    ////                     public methods                        ////


    public Object clone() throws CloneNotSupportedException {
        ModelView actor = (ModelView) super.clone();
        actor._parser = new MoMLParser();
        return actor;
    }

View Full Code Here

                throw new IllegalActionException(this, ex, "Failed to parse '"
                        + modelPathOrURL + "'");
            }
        }


        MoMLParser parser = new MoMLParser();


        // Get the old filters, save them, add our own
        // filters, use them, remove our filters,
        // and then readd the old filters in the finally clause.
        List oldFilters = MoMLParser.getMoMLFilters();
        MoMLParser.setMoMLFilters(null);


        // Parse the model and get the name of the model.
        try {
            // Handle Backward Compatibility.
            MoMLParser.addMoMLFilters(BackwardCompatibility.allFilters());


            // Filter out any graphical classes
            RemoveGraphicalClasses filter = new RemoveGraphicalClasses();


            // FIXME: Not sure why this is necessary, but it helps
            // when generating an applet for moml/demo/spectrum.xml
            filter.put("ptolemy.kernel.util.Location", null);
            MoMLParser.addMoMLFilter(filter);


            NamedObj toplevel = null;


            try {
                toplevel = parser.parse(null, modelURL);


                // FIXME: 1st arg of parse() could be $PTII as a URL.
                modelPathOrURL = modelURL.toExternalForm();
            } catch (FileNotFoundException ex) {
                try {
                    // Might be under Web Start, try it this way.
                    URL anotherURL = ClassUtilities
                            .jarURLEntryResource(modelPathOrURL);


                    if (anotherURL != null) {
                        toplevel = parser.parse(null, anotherURL);
                        modelPathOrURL = anotherURL.toExternalForm();
                    } else {
                        throw new Exception("1. Failed to find '"
                                + modelURL.toExternalForm() + "'\n"
                                + "2. Failed to find '" + modelPathOrURL + "'");

View Full Code Here

                // default XML description.
                URL source = getClass()
                        .getClassLoader()
                        .getResource(
                                "ptolemy/vergil/kernel/attributes/iconEditorLibrary.xml");
                MoMLParser parser = new MoMLParser(workspace);


                try {
                    result = (CompositeEntity) parser.parse(null, source);
                } catch (Exception e) {
                    throw new InternalErrorException(
                            "Unable to open default icon editor library: " + e);
                }
            }

View Full Code Here

        String moml = getModel().exportMoML();
        boolean modified = isModified();
        setModified(false);
        close();


        MoMLParser parser = new MoMLParser();
        try {
            Tableau tableau = getFrameController().getConfiguration().openModel(
                    parser.parse(moml));
            Frame frame = tableau.getFrame();
            if (modified && (frame instanceof TableauFrame)) {
                ((TableauFrame) tableau.getFrame()).setModified(true);
            }
        } catch (Exception e) {

View Full Code Here

     *   to use the default.
     *  @exception Exception If the parser cannot parse the file.
     */
    public TreeEditorPanel(String filename, TreeCellRenderer cellRenderer)
            throws Exception {
        _parser = new MoMLParser();


        // FIXME: This should use the Configuration.
        _toplevel = _parser.parseFile(filename);


        if (_toplevel instanceof CompositeEntity) {

View Full Code Here

                        + modelPathOrURL + "'");
            }
        }


        // Create a parser.
        _parser = new MoMLParser();


        // Handle Backward Compatibility.
        MoMLParser.addMoMLFilters(BackwardCompatibility.allFilters());


        // Filter out any graphical classes and the GeneratorAttribute

View Full Code Here

            // Ignore blank argument.
        } else {
            if (_expectingClass) {
                _expectingClass = false;


                MoMLParser parser = new MoMLParser();
                String string = "<entity name=\"toplevel\" class=\"" + arg
                        + "\"/>";
                CompositeActor model = (CompositeActor) parser.parse(string);


                // Temporary hack because cloning doesn't properly clone
                // type constraints.
                CompositeActor modelClass = (CompositeActor) parser
                        .searchForClass(arg, model.getSource());


                if (modelClass != null) {
                    model = modelClass;
                }

View Full Code Here

            boolean filterGraphicalClasses) throws Exception {
        // ptolemy.vergil.MoMLViewerApplet() calls this with
        // filterGraphicalClasses set to false.
        _modelURL = _readModelURLParameter();


        MoMLParser parser = new MoMLParser();


        // FIXME: if we call _createModel twice, then we will add
        // this filter twice.  We reset the filter list here,
        // though we will lose any other filters.
        MoMLParser.setMoMLFilters(null);


        MoMLParser.setMoMLFilters(BackwardCompatibility.allFilters());


        RemoveGraphicalClasses removeNonAppletClasses = new RemoveGraphicalClasses();
        // If filterGraphicalClasses is true, then we filter out
        // graphical classes so that we do not require diva.jar.  If
        // it is false, then we clear the filter.  In both cases we
        // add some classes that are always filtered.
        if (!filterGraphicalClasses) {
            RemoveGraphicalClasses.clear();
        }


        // Exclude the code generator
        removeNonAppletClasses.put(
                "ptolemy.codegen.kernel.StaticSchedulingCodeGenerator", null);
        removeNonAppletClasses
                .put("ptolemy.vergil.kernel.attributes.DocumentationAttribute",
                        null);
        MoMLParser.addMoMLFilter(removeNonAppletClasses);


        URL docBase = getDocumentBase();
        URL xmlFile = new URL(docBase, _modelURL);
        _manager = null;


        NamedObj toplevel = parser.parse(docBase, xmlFile);
        _workspace = toplevel.workspace();


        if ((_fragment != null) && !_fragment.trim().equals("")) {
            // A fragment was specified, so we should look inside.
            ComponentEntity inside = null;

View Full Code Here


        // The Ptolemy II model returned by the Java parser.
        NamedObj toplevel;


        try {
            MoMLParser parser = new MoMLParser();
            toplevel = parser.parseFile(args[0]);
        } catch (Exception ex) {
            throw new RuntimeException(ex.getMessage()
                    + "Exception raised from the MoML parser\n");
        }

View Full Code Here

0 1 2 3 4 5

TOP

Related Classes of ptolemy.moml.MoMLParser$UnlinkRequest

com.microstar.xml.XmlParser

fr.soleil.bossanova.configuration.ActorRepository

ptolemy.actor.gt.GraphMatcher

ptolemy.actor.gt.ModelGenerator

ptolemy.actor.gt.ModelView

ptolemy.actor.gui.CheckModelSize

ptolemy.actor.gui.CompositeActorApplication

ptolemy.actor.gui.CompositeActorSimpleApplication

ptolemy.actor.gui.MoMLApplet

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.