Weitere Ergänzungen.

git-svn-id: https://svn.libreccm.org/ccm/trunk@1476 8810af33-2d31-482b-a856-94f89814c4df

ccm-sci-publications/src/com/arsdigita/cms/contenttypes/ArticleInCollectedVolumeInitializer.java

@@ -17,15 +17,25 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  *
  */
+
 package com.arsdigita.cms.contenttypes;
 
 /**
+ * Executes at each system startup and initializes the ArticleInCollectedVolume 
+ * content type.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter
  */
 public class ArticleInCollectedVolumeInitializer extends ContentTypeInitializer {
 
     /**
+     * Constructor, sets the PDL manifest file and object type string.
+     * 
      * The pdl.mf file used here is empty, since the
      * {@link PublicationInitializer} loads all things using the pdl.mf file
      * of the module. Also, it may causes on silly errors in the load-bundle
@@ -35,14 +45,33 @@ public class ArticleInCollectedVolumeInitializer extends ContentTypeInitializer
         super("empty.pdl.mf", ArticleInCollectedVolume.BASE_DATA_OBJECT_TYPE);
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
-        return new String[]{"/static/content-types/com/arsdigita/cms/contenttypes/ArticleInCollectedVolume.xsl"};
+        return new String[]{
+            INTERNAL_THEME_TYPES_DIR + "sci/ArticleInCollectedVolume.xsl"};
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
-        return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/ArticleInCollectedVolume.xml";
+        return 
+        "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/ArticleInCollectedVolume.xml";
     }
 
 }

ccm-sci-publications/src/com/arsdigita/cms/contenttypes/ArticleInJournalInitializer.java

@@ -17,15 +17,25 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  *
  */
+
 package com.arsdigita.cms.contenttypes;
 
 /**
+ * Executes at each system startup and initializes the ArticleInJournal 
+ * content type.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter
  */
 public class ArticleInJournalInitializer extends ContentTypeInitializer {
 
     /**
+     * Constructor, sets the PDL manifest file and object type string.
+     * 
      * The pdl.mf file used here is empty, since the
      * {@link PublicationInitializer} loads all things using the pdl.mf file
      * of the module. Also, it may causes on silly errors in the load-bundle
@@ -35,11 +45,29 @@ public class ArticleInJournalInitializer extends ContentTypeInitializer {
         super("empty.pdl.mf", ArticleInJournal.BASE_DATA_OBJECT_TYPE);
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
-        return new String[]{"/static/content-types/com/arsdigita/cms/contenttypes/ArticleInJournal.xsl"};
+        return new String[]{
+            INTERNAL_THEME_TYPES_DIR + "sci/ArticleInJournal.xsl"};
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
         return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/ArticleInJournal.xml";

ccm-sci-publications/src/com/arsdigita/cms/contenttypes/CollectedVolumeInitializer.java

@@ -17,15 +17,25 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  *
  */
+
 package com.arsdigita.cms.contenttypes;
 
 /**
+ * Executes at each system startup and initializes the CollectedVolume 
+ * content type.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter
  */
 public class CollectedVolumeInitializer extends ContentTypeInitializer {
 
     /**
+     * Constructor, sets the PDL manifest file and object type string.
+     * 
      * The pdl.mf file used here is empty, since the
      * {@link PublicationInitializer} loads all things using the pdl.mf file
      * of the module. Also, it may causes on silly errors in the load-bundle
@@ -35,14 +45,32 @@ public class CollectedVolumeInitializer extends ContentTypeInitializer {
         super("empty.pdl.mf", CollectedVolume.BASE_DATA_OBJECT_TYPE);
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
-        return new String[]{"/static/content-types/com/arsdigita/cms/contenttypes/CollectedVolume.xsl"};
+        return new String[]{"INTERNAL_THEME_TYPES_DIR + sci/CollectedVolume.xsl"};
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
-        return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/CollectedVolume.xml";
+        return 
+        "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/CollectedVolume.xml";
     }
 
 }

ccm-sci-publications/src/com/arsdigita/cms/contenttypes/ExpertiseInitializer.java

@@ -17,15 +17,24 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  *
  */
+
 package com.arsdigita.cms.contenttypes;
 
 /**
+ * Executes at each system startup and initializes the Expertise content type.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter
  */
 public class ExpertiseInitializer extends ContentTypeInitializer {
 
     /**
+     * Constructor, sets the PDL manifest file and object type string.
+     * 
      * The pdl.mf file used here is empty, since the
      * {@link PublicationInitializer} loads all things using the pdl.mf file
      * of the module. Also, it may causes on silly errors in the load-bundle
@@ -35,14 +44,32 @@ public class ExpertiseInitializer extends ContentTypeInitializer {
         super("empty.pdl.mf", Expertise.BASE_DATA_OBJECT_TYPE);
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
-        return new String[]{"/static/content-types/com/arsdigita/cms/contenttypes/Expertise.xsl"};
+        return new String[]{INTERNAL_THEME_TYPES_DIR + "sci/Expertise.xsl"};
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
-        return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/Expertise.xml";
+        return 
+        "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/Expertise.xml";
     }
 
 }

ccm-sci-publications/src/com/arsdigita/cms/contenttypes/GreyLiteratureInitializer.java

@@ -17,15 +17,25 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  *
  */
+
 package com.arsdigita.cms.contenttypes;
 
 /**
+ * Executes at each system startup and initializes the GreyLiterature 
+ * content type.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter
  */
 public class GreyLiteratureInitializer extends ContentTypeInitializer {
 
     /**
+     * Constructor, sets the PDL manifest file and object type string.
+     * 
      * The pdl.mf file used here is empty, since the
      * {@link PublicationInitializer} loads all things using the pdl.mf file
      * of the module. Also, it may causes on silly errors in the load-bundle
@@ -35,14 +45,32 @@ public class GreyLiteratureInitializer extends ContentTypeInitializer {
         super("empty.pdl.mf", GreyLiterature.BASE_DATA_OBJECT_TYPE);
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
-        return new String[]{"/static/content-types/com/arsdigita/cms/contenttypes/GreyLiterature.xsl"};
+        return new String[]{INTERNAL_THEME_TYPES_DIR + "sci/GreyLiterature.xsl"};
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
-        return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/GreyLiterature.xml";
+        return 
+        "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/GreyLiterature.xml";
     }
 
 }

ccm-sci-publications/src/com/arsdigita/cms/contenttypes/InProceedingsInitializer.java

@@ -17,15 +17,24 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  *
  */
+
 package com.arsdigita.cms.contenttypes;
 
 /**
+ * Executes at each system startup and initializes the InProceedings content type.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter
  */
 public class InProceedingsInitializer extends ContentTypeInitializer {
 
     /**
+     * Constructor, sets the PDL manifest file and object type string.
+     * 
      * The pdl.mf file used here is empty, since the
      * {@link PublicationInitializer} loads all things using the pdl.mf file
      * of the module. Also, it may causes on silly errors in the load-bundle
@@ -35,14 +44,32 @@ public class InProceedingsInitializer extends ContentTypeInitializer {
         super("empty.pdl.mf", InProceedings.BASE_DATA_OBJECT_TYPE);
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
-        return new String[]{"/static/content-types/com/arsdigita/cms/contenttypes/InProceedings.xsl"};
+        return new String[]{INTERNAL_THEME_TYPES_DIR + "sci/InProceedings.xsl"};
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
-        return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/InProceedings.xml";
+        return 
+        "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/InProceedings.xml";
     }
 
 }

ccm-sci-publications/src/com/arsdigita/cms/contenttypes/InternetArticleInitializer.java

@@ -17,9 +17,17 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  *
  */
+
 package com.arsdigita.cms.contenttypes;
 
 /**
+ * Executes at each system startup and initializes the InternetArticle 
+ * content type, part of the ScientificCMS extension.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter
  */
@@ -35,11 +43,28 @@ public class InternetArticleInitializer extends ContentTypeInitializer {
         super("empty.pdl.mf", InternetArticle.BASE_DATA_OBJECT_TYPE);
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
-        return new String[]{"/static/content-types/com/arsdigita/cms/contenttypes/InternetArticle.xsl"};
+        return new String[]{INTERNAL_THEME_TYPES_DIR + "sci/InternetArticle.xsl"};
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
         return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/Publication.xml";

ccm-sci-publications/src/com/arsdigita/cms/contenttypes/PublicationInitializer.java

@@ -17,6 +17,7 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  *
  */
+
 package com.arsdigita.cms.contenttypes;
 
 import com.arsdigita.cms.contenttypes.ui.GenericOrganizationalUnitPublicationsStep;
@@ -27,12 +28,20 @@ import com.arsdigita.runtime.DomainInitEvent;
 import org.apache.log4j.Logger;
 
 /**
+ * Executes at each system startup and initializes the Publication content type,
+ * part of the ScientificCMS extension.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter
  * @version $Id$
  */
 public class PublicationInitializer extends ContentTypeInitializer {
 
+    /** Private Logger instance for debugging purpose.                        */
     private final Logger logger = Logger.getLogger(PublicationInitializer.class);
 
     public PublicationInitializer() {
@@ -78,12 +87,29 @@ public class PublicationInitializer extends ContentTypeInitializer {
         }
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
         return new String[]{
-                    "/static/content-types/com/arsdigita/cms/contenttypes/Publication.xsl"};
+                    INTERNAL_THEME_TYPES_DIR + "sci/Publication.xsl"};
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
         return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/Publication.xml";

ccm-sci-types-member/src/com/arsdigita/cms/contenttypes/SciMemberInitializer.java

@@ -1,6 +1,33 @@
+/*
+ * Copyright (c) 2010 Jens Pelzetter,
+ * for the Center of Social Politics of the University of Bremen
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public License
+ * as published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ *
+ */
+
 package com.arsdigita.cms.contenttypes;
 
 /**
+ * Executes at each system startup and initializes the SciMember content type,
+ * part of the ScientificCMS extension.
+ * 
+ * Defines the content type specific properties and just uses the super class
+ * methods to register the content type with the (transient) content type store
+ * (map). This is done by runtimeRuntime startup method which runs the init()
+ * methods of all initializers (this one just using the parent implementation).
  *
  * @author Jens Pelzetter 
  * @version $Id$
@@ -11,13 +38,30 @@ public class SciMemberInitializer extends ContentTypeInitializer {
         super("ccm-sci-types-member.pdl.mf", SciMember.BASE_DATA_OBJECT_TYPE);
     }
 
+    /**
+     * Retrieve location of this content type's internal default theme 
+     * stylesheet(s) which concomitantly serve as a fallback if a custom theme 
+     * is engaged. 
+     * 
+     * Custom themes usually will provide their own stylesheet(s) and their own
+     * access method, but may not support every content type.
+     * 
+     * Overwrites parent method with AgendaItem specific value for use by the 
+     * parent class worker methods.
+     * 
+     * @return String array of XSL stylesheet files of the internal default theme
+     */
     @Override
     public String[] getStylesheets() {
         return new String[]{
-                    "/static/content-types/com/arsdigita/cms/contenttypes/SciMember.xsl"
+                    INTERNAL_THEME_TYPES_DIR + "sci/SciMember.xsl"
                 };
     }
 
+    /**
+     * Retrieves fully qualified traversal adapter file name.
+     * @return 
+     */
     @Override
     public String getTraversalXML() {
         return "/WEB-INF/traversal-adapters/com/arsdigita/cms/contenttypes/SciMember.xml";