Application: gvSIG desktop » gvSIG scripting

package org.gvsig.scripting;

import java.io.File;

import java.net.URL;

import java.util.Iterator;

import java.util.List;

import java.util.Map;

import javax.help.HelpSet;

public interface ScriptingHelpManager {

        public interface ScriptingHelpAPI{

                public String getName();

        }

        public interface ScriptingHelpClass{

                public String getName();

                public String getUrl();

        }

        public interface ScriptingHelpMethod extends Iterable{

                public String getName();

                public Iterator<ScriptingHelpClass> iterator();

        }

        /**

         * Returns the directory of the Help's content

         * 

         * @return a File with the Help's Folder 

         */

        public File getFolder();

        public List<ScriptingHelpAPI> getAPI();

        public List<ScriptingHelpMethod> getMethods();

        /**

         * Gets the methods of all the classes includes on the JavaDocs which matches with a text

         * 

         * @parama text String with the text to get the methods that contains it

         * 

         * @return a HashMap with the references founded

         * 

         */

        public Map<String,ScriptingHelpMethod> findMethods(String text);

        /**

         * Returns the HelpSet with the Help information of the JavaDocs registered

         * 

         * @return a HelpSet with the Help content

         */

        public HelpSet getHelpSet();

        /**

         * Reloads the Help information of the JavaDocs

         * 

         */

        public void reloadHelp();

        /**

         * Removes a help module from the application's helpset

         * 

         * @param name String with the identificator of the module help to remove

         * 

         */

        public void removeHelp(String name);

        /**

         * Checks if exists a help module from the application's helpset with the same identificator

         * 

         * @param name String with the identificator of the module help to check

         * 

         * @return true if exists, false if not

         * 

         */

        public boolean existsHelp(String name);

        /**

         * Adds a new help module to the application's helpset with the identificator specified

         * 

         * @param name String with the identificator of the module help to add

         * @param url URL with the root directory of the help to import 

         * 

         * @return true if exists, false if not

         * 

         */

        public void importHelp(String name, URL url);

}