View Javadoc

1   /*
2    * Copyright 2005 Jukka Zitting <jz@yukatan.fi>
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not 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.
15   */
16  package net.sf.exorcist.api;
17  
18  /***
19   * Importer plugin interface. This is the interface implemented by
20   * the Exorcist importer plugins. Importer plugins are used to import
21   * content from a {@link ContentState ContentState} instance into a
22   * selected location within a target content repository.
23   */
24  public interface ContentImporter {
25  
26      /***
27       * Imports content into a target content repository. The content to
28       * import is contained in the content state instance passed by
29       * the Exorcist framework as the argument.
30       *
31       * @param state the content state snapshot to be imported
32       * @throws ContentException if the selected content could not be imported
33       */
34      void importContent(ContentState state) throws ContentException;
35  
36  }