/* 
    P/P   *  Method: org.apache.roller.weblogger.business.themes.ThemeManager__static_init
          */
     1  /*
     2   * Licensed to the Apache Software Foundation (ASF) under one or more
     3   *  contributor license agreements.  The ASF licenses this file to You
     4   * under the Apache License, Version 2.0 (the "License"); you may not
     5   * use this file except in compliance with the License.
     6   * You may obtain a copy of the License at
     7   *
     8   *     http://www.apache.org/licenses/LICENSE-2.0
     9   *
    10   * Unless required by applicable law or agreed to in writing, software
    11   * distributed under the License is distributed on an "AS IS" BASIS,
    12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13   * See the License for the specific language governing permissions and
    14   * limitations under the License.  For additional information regarding
    15   * copyright in this work, please see the NOTICE file in the top level
    16   * directory of this distribution.
    17   */
    18  
    19  package org.apache.roller.weblogger.business.themes;
    20  
    21  import java.util.List;
    22  import org.apache.roller.weblogger.WebloggerException;
    23  import org.apache.roller.weblogger.business.InitializationException;
    24  import org.apache.roller.weblogger.pojos.WeblogTheme;
    25  import org.apache.roller.weblogger.pojos.Weblog;
    26  
    27  
    28  /**
    29   * Manager interface for accessing Theme related objects.
    30   */
    31  public interface ThemeManager {
    32      
    33      /**
    34       * Initialize the theme system.
    35       *
    36       * @throws InitializationException If there is a problem during initialization.
    37       */
    38      public void initialize() throws InitializationException;
    39      
    40      
    41      /**
    42       * Get the Theme object with the given id.
    43       *
    44       * @return Theme The Theme object with the given id.
    45       * @throws ThemeNotFoundException If the named theme cannot be found.
    46       * @throws WebloggerException If there is some kind of fatal backend error.
    47       **/
    48      public SharedTheme getTheme(String id)
    49          throws ThemeNotFoundException, WebloggerException;
    50      
    51      
    52      /**
    53       * Get the WeblogTheme for a given weblog.
    54       *
    55       * @param weblog The weblog to get the theme for.
    56       * @return WeblogTheme The theme to be used for the given weblog.
    57       * @throws WebloggerException If there is some kind of fatal backend error.
    58       */
    59      public WeblogTheme getTheme(Weblog weblog)
    60          throws WebloggerException;
    61      
    62      
    63      /**
    64       * Get a list of all theme names that are currently enabled.
    65       * This list is ordered alphabetically by default.
    66       *
    67       * @return List A list of Theme objects which are enabled.
    68       */
    69      public List getEnabledThemesList();
    70      
    71      
    72      /**
    73       * Import all the contents for a Theme into a weblog.
    74       *
    75       * @param weblog The weblog to import the theme into.
    76       * @param theme The theme that should be imported.
    77       *
    78       * @throws WebloggerException If there is some kind of error in saving.
    79       */
    80      public void importTheme(Weblog website, SharedTheme theme) 
    81          throws WebloggerException;
    82      
    83  }