Daemon.java

  1. /*
  2.  * Copyright (c) 2002-2022, City of Paris
  3.  * All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms, with or without
  6.  * modification, are permitted provided that the following conditions
  7.  * are met:
  8.  *
  9.  *  1. Redistributions of source code must retain the above copyright notice
  10.  *     and the following disclaimer.
  11.  *
  12.  *  2. Redistributions in binary form must reproduce the above copyright notice
  13.  *     and the following disclaimer in the documentation and/or other materials
  14.  *     provided with the distribution.
  15.  *
  16.  *  3. Neither the name of 'Mairie de Paris' nor 'Lutece' nor the names of its
  17.  *     contributors may be used to endorse or promote products derived from
  18.  *     this software without specific prior written permission.
  19.  *
  20.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  21.  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23.  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
  24.  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  25.  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  26.  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  27.  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  28.  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  29.  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  30.  * POSSIBILITY OF SUCH DAMAGE.
  31.  *
  32.  * License 1.0
  33.  */
  34. package fr.paris.lutece.portal.service.daemon;

  35. /**
  36.  * Interfaces for Daemons Service.
  37.  */
  38. public abstract class Daemon implements Runnable
  39. {
  40.     // //////////////////////////////////////////////////////////////////////////////
  41.     // Constants
  42.     public static final int STATUS_STOPPED = 0;
  43.     public static final int STATUS_RUNNING = 1;

  44.     /** The result for this daemon is not yet known. */
  45.     public static final int RESULT_UNKNOWN = 0;

  46.     /** A daemon has processed and it was successful */
  47.     public static final int RESULT_SUCCESS = 1;

  48.     /** A daemon has processed but it has failed */
  49.     public static final int RESULT_FAILED = 2;

  50.     /** A daemon is processing so its result is not yet known */
  51.     public static final int RESULT_PROCESSING = 3;
  52.     private StringBuilder _sbLastRunLogs;
  53.     private int _nResult;
  54.     private String _strPluginName;

  55.     /**
  56.      * Gets the plugin name
  57.      *
  58.      * @return the plugin name
  59.      */
  60.     public String getPluginName( )
  61.     {
  62.         return _strPluginName;
  63.     }

  64.     /**
  65.      * Sets the plugin name
  66.      *
  67.      * @param pluginName
  68.      *            The plugin name
  69.      */
  70.     public void setPluginName( String pluginName )
  71.     {
  72.         _strPluginName = pluginName;
  73.     }

  74.     /**
  75.      * Returns the LastRunLogs
  76.      *
  77.      * @return The LastRunLogs
  78.      */
  79.     public String getLastRunLogs( )
  80.     {
  81.         return ( _sbLastRunLogs != null ?_sbLastRunLogs.toString( ) : "" );
  82.     }

  83.     /**
  84.      * Sets the LastRunLogs
  85.      *
  86.      * @param strLastRunLogs
  87.      *            The LastRunLogs
  88.      */
  89.     public void setLastRunLogs( String strLastRunLogs )
  90.     {
  91.         _sbLastRunLogs = new StringBuilder( strLastRunLogs ) ;
  92.     }

  93.     /**
  94.      * Append to LastRunLogs
  95.      *
  96.      * @param strLastRunLogsPart
  97.      *            The LastRunLogs part
  98.      */
  99.     public void appendLastRunLogs( String strLastRunLogsPart )
  100.     {
  101.         if ( _sbLastRunLogs == null )
  102.         {
  103.             _sbLastRunLogs = new StringBuilder( strLastRunLogsPart ) ;
  104.         }
  105.         else
  106.         {
  107.             _sbLastRunLogs.append( strLastRunLogsPart ) ;
  108.         }
  109.        
  110.     }

  111.     /**
  112.      * Returns the Result
  113.      *
  114.      * @return The Result
  115.      */
  116.     public int getResult( )
  117.     {
  118.         return _nResult;
  119.     }

  120.     /**
  121.      * Sets the Result
  122.      *
  123.      * @param nResult
  124.      *            The Result
  125.      */
  126.     public void setResult( int nResult )
  127.     {
  128.         _nResult = nResult;
  129.     }

  130.     /**
  131.      * Stop the daemon. Clean up allocated resources
  132.      */
  133.     protected void stop( )
  134.     {
  135.         // nothing by default
  136.     }
  137. }