src/examples/api/document-markup/Main.java

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 * 
 *      http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */ 

/** 
 * A simple "test harness" which demonstrates how the MarkupDigester class
 * (plus the supporting interface/rule classes) can process "document-markup"
 * style xml data.
 * <p>
 * See the readme file included with this example for more information.
 */
 
public class Main {
    /** The input xml to be parsed by this example. */
    String in = "<p>Hi, this is an <i>example</i> of some <b>bold</b> text.</p>";
   
    /** Invoked when a text segment is present in the parsed input. */
    public void addSegment(String text) {
        System.out.println("Text segment: [" + text + "]");
    }
    
    /** Invoked when an &lt;i&gt; node is found in the parsed input. */
    public void addItalic(String text) {
        System.out.println("Italic: [" + text + "]");
    }
    
    /** Invoked when an &lt;b&gt; node is found in the parsed input. */
    public void addBold(String text) {
        System.out.println("Bold: [" + text + "]");
    }
    
    /** 
     * Invoked via a standard Digester CallMethodRule, passing the 
     * "body text" of the top-level xml element. This demonstrates
     * the default behaviour of Digester (which is not suitable for
     * processing markup-style xml). 
     */
    public void addAllText(String text) {
        System.out.println(
            "And the merged text for the p element is [" + text + "]");
    }
    
    /**
     * Main method of this test harness. Set up some digester rules,
     * then parse the input xml contained in the "in" member variable.
     * The rules cause methods on this object to be invoked, which just
     * dump information to standard output, to show the callbacks that
     * a real program could arrange to get when parsing markup input.
     */
    public void run() throws Exception {
        System.out.println("Started.");        
        MarkupDigester d = new MarkupDigester();
    
        d.push(this);
        
        SetTextSegmentRule r = new SetTextSegmentRule("addSegment");
        d.addRule("p", r);
        d.addCallMethod("p", "addAllText", 0);

        d.addCallMethod("p/i", "addItalic", 0);
        d.addCallMethod("p/b", "addBold", 0);
        
        d.parse(new java.io.StringReader(in));
        

        System.out.println("Finished.");        
    }

    /** See the run method. */    
    public static void main(String[] args) throws Exception {
        new Main().run();
    }
}