Changeset 3662


Ignore:
Timestamp:
Aug 14, 2007, 8:54:58 AM (16 years ago)
Author:
Martin Svensson
Message:

Fixes #551 Read "Plugin developer" section

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/src/docbook/developerdoc/plugin_developer.xml

    r3646 r3662  
    545545                out from this method. Always use <code>try...catch</code>
    546546                to catch exceptions and use <code>Response.setError()</code>
    547                 to reporter the error back to the core.
     547                to report the error back to the core.
    548548              </important>
    549549             
     
    13101310          <methodname>Plugin.requiresConfiguration()</methodname> and
    13111311          <methodname>Plugin.getAbout()</methodname> to find out information
    1312           about the plug-in. This is the only time theese methods are called.
     1312          about the plug-in. This is the only time these methods are called.
    13131313          The information that is returned by them are copied and stored in
    13141314          the database for easy access.
     
    15061506        <para>
    15071507          If the web client found that the plug-in could be
    1508           used in a given context and the user selected the plug-in
     1508          used in a given context and the user selected the plug-in,
    15091509          the job configuration sequence is started. It is a wizard-like interface
    15101510          identical to the configuration wizard. In fact, the same JSP pages,
     
    15911591          <para>
    15921592          The <methodname>Plugin.run()</methodname> method is called.
    1593           It is finally time for the plug-in to do the work it has bee
     1593          It is finally time for the plug-in to do the work it has been
    15941594          designed for. This method should not throw any exceptions.
    15951595          Use the <methodname>Response.setDone()</methodname>
     
    17281728
    17291729    <para>
    1730       A plugin becoms an import plugin simply by returning
     1730      A plugin becomes an import plugin simply by returning
    17311731      <constant>Plugin.MainType.IMPORT</constant>
    17321732      from the <methodname>Plugin.getMainType()</methodname> method.
     
    17991799              Note that the input stream doesn't have to be a text file.
    18001800              It can be any type of file, for example a binary or an XML file.
    1801               In the case of an XML file you would need to validate the entiry
     1801              In the case of an XML file you would need to validate the entire
    18021802              input stream in order to be a 100% sure that it is a valid
    18031803              xml file, but we recommend that you only check the first few XML tags,
     
    19341934        for configuring the plugin and creating a job and implement the
    19351935        <methodname>InteractivePlugin.configure()</methodname> method for validating and
    1936         storing the parameteters. You should also implement or override some methods
     1936        storing the parameters. You should also implement or override some methods
    19371937        defined by <classname>AbstractFlatFileImporter</classname>.
    19381938      </para>
     
    20452045          <classname>PluginParameter</classname> objects and has stored the values
    20462046          at the configuration level. You should override this method if you need to
    2047           initiailise the parser in a different way. See for example the
     2047          initialise the parser in a different way. See for example the
    20482048          code for the <classname>PrintMapFlatFileImporter</classname> plug-in which
    20492049          has a fixed format and doesn't use configurations.
     
    20882088          TRUE, since obviously some data has been found. A subclass may override this method
    20892089          if it wants to do more checks, for example, make that a certain header is present
    2090           with a certain value. It may also continut parsing the file. Here is a code example from
     2090          with a certain value. It may also continue parsing the file. Here is a code example from
    20912091          the <classname>PrintMapFlatFileImporter</classname> which checks if a
    20922092          <constant>FormatName</constant> header is present and contains either
     
    26082608        <methodname>ImmediateDownloadExporter.doExport()</methodname> method.
    26092609        Here is what you need to do in your own plug-in code (code examples are
    2610         take from the <classname>HelpExporter</classname>):
     2610        taken from the <classname>HelpExporter</classname>):
    26112611      </para>
    26122612     
     
    30393039      <para>
    30403040        The <interfacename>net.sf.basedb.core.plugin.AnalysisFilterPlugin</interfacename>
    3041         is a tagging interface with no methods that all analysis plug-ins that only filters
     3041        is a tagging interface, with no methods, that all analysis plug-ins that only filters
    30423042        data should implement. The benefit is that they will be linked from the
    30433043        <guibutton>Filter bioassay set</guibutton> button and not just
     
    30793079        <para>
    30803080          BASE can authenticate users in two ways. Either it uses the internal
    3081           authentiction or the external authentication. With internal
     3081          authentication or the external authentication. With internal
    30823082          authentication BASE stores logins and passwords in its own database.
    30833083          With external authentication this is handled by some external
     
    37553755              <para>
    37563756              The <varname>progress</varname> parameter, if not
    3757               <constant>null</constant>, should be used to reporter the
     3757              <constant>null</constant>, should be used to report the
    37583758              progress back to the calling code. The plug-in should count
    37593759              the number of bytes read from the <varname>in</varname>
Note: See TracChangeset for help on using the changeset viewer.