X-Git-Url: http://lists.indexdata.dk/cgi-bin?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fcom%2Findexdata%2Fmkjsf%2Fpazpar2%2Fcommands%2Fsp%2FCategoriesCommand.java;h=b3794ecb4ad64a8d5e014c686c01eacfa8e1fe19;hb=7df6b1590eb285bca094652950a23edc3da95f70;hp=bccd65c0a744f7e60ffff22674adfb85b961aa45;hpb=9cd922c29f423b69da6f52eabf0c7fdb0b0b6ca5;p=mkjsf-moved-to-github.git

diff --git a/src/main/java/com/indexdata/mkjsf/pazpar2/commands/sp/CategoriesCommand.java b/src/main/java/com/indexdata/mkjsf/pazpar2/commands/sp/CategoriesCommand.java
index bccd65c..b3794ec 100644
--- a/src/main/java/com/indexdata/mkjsf/pazpar2/commands/sp/CategoriesCommand.java
+++ b/src/main/java/com/indexdata/mkjsf/pazpar2/commands/sp/CategoriesCommand.java
@@ -6,6 +6,20 @@ import com.indexdata.mkjsf.pazpar2.Pz2Service;
 import com.indexdata.mkjsf.pazpar2.commands.Pazpar2Command;
 import com.indexdata.mkjsf.pazpar2.data.sp.CategoriesResponse;
 
+/**
+ * Retrieves target categories available to the current Service Proxy user.
+ * <p>
+ * Target categories can be used to limit a search to resources tagged with the given 
+ * category. The following request in a Faces page would obtain categories for displaying, say, a select list:
+ * <p>
+ *  pzreq.sp.categories.run().targetCategories   
+ * <p>
+ * This would get the Service Proxy extension commands, pick the categories command, execute it, and retrieve
+ *  a list of TargetCategory objects from the returned response data object.  
+ * </p>
+ * @author Niels Erik
+ *
+ */
 public class CategoriesCommand extends Pazpar2Command implements ServiceProxyCommand {
 
   private static final long serialVersionUID = 5023993689780291641L;