planetgroupdata.java

这个weblogging 设计得比较精巧

/*
 * Copyright 2005 Sun Microsystems, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.roller.pojos;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
import java.util.Set;
import java.util.StringTokenizer;
import java.util.TreeSet;


/**
 * @struts.form include-all="true"
 * @ejb:bean name="PlanetGroupData"
 * @hibernate.class table="rag_group"
 */
public class PlanetGroupData extends PersistentObject implements Serializable
{
    transient private String[] catArray = null;

    /** Database ID */
    protected String id;
    
    /** Unique handle by which group may be fetched */
    protected String handle;
    
    /** Title of this group */
    protected String title;
    
    /** Description of this group */
    protected String description;
    
    /** Restrict group by this list of comma separated category names */
    protected String categoryRestriction;
    
    /** Max number of entries to show in HTML representation of this group */
    protected int maxPageEntries = 45;
    
    /** Max number of entries to show in feed representation of this group */
    protected int maxFeedEntries = 45;
    
    /** Subscriptions in this group */
    protected List subscriptionAssocs = new ArrayList();

    //------------------------------------------------------- persistent fields

    /** 
     * @ejb:persistent-field 
     * @hibernate.id column="id" type="string" 
     *     generator-class="uuid.hex" unsaved-value="null"
     */
    public String getId()
    {
        return id;
    }
    public void setId(String id)
    {
        this.id = id;
    }
    /** 
     * @hibernate.bag lazy="false" inverse="true" cascade="delete" 
     * @hibernate.collection-key column="group_id"
     * @hibernate.collection-one-to-many 
     *    class="org.roller.pojos.PlanetGroupSubscriptionAssoc"
     */
    public List getGroupSubscriptionAssocs()
    {
        return subscriptionAssocs;
    }
    public void setGroupSubscriptionAssocs(List subscriptionAssocs)
    {
        this.subscriptionAssocs = subscriptionAssocs;
    }
    /** 
     * @hibernate.property column="cat_restriction" non-null="false" unique="false"
     */
    public String getCategoryRestriction()
    {
        return categoryRestriction;
    }
    public void setCategoryRestriction(String categoryRestriction)
    {
        this.categoryRestriction = categoryRestriction;
        catArray = null;
    }
    /** 
     * @hibernate.property column="description" non-null="false" unique="false"
     */
    public String getDescription()
    {
        return description;
    }
    public void setDescription(String description)
    {
        this.description = description;
    }
    /** 
     * @hibernate.property column="handle" non-null="false" unique="false"
     */
    public String getHandle()
    {
        return handle;
    }
    public void setHandle(String handle)
    {
        this.handle = handle;
    }
    /** 
     * @hibernate.property column="max_feed_entries" non-null="false" unique="false"
     */
    public int getMaxFeedEntries()
    {
        return maxFeedEntries;
    }
    public void setMaxFeedEntries(int maxFeedEntries)
    {
        this.maxFeedEntries = maxFeedEntries;
    }
    /** 
     * @hibernate.property column="max_page_entries" non-null="false" unique="false"
     */
    public int getMaxPageEntries()
    {
        return maxPageEntries;
    }
    public void setMaxPageEntries(int maxPageEntries)
    {
        this.maxPageEntries = maxPageEntries;
    }
    /** 
     * @hibernate.property column="title" non-null="false" unique="false"
     */
    public String getTitle()
    {
        return title;
    }
    public void setTitle(String title)
    {
        this.title = title;
    }

    //--------------------------------------------------------------- app logic

    /**
     * Returns true if entry is qualified for inclusion in this group.
     */
    public boolean qualified(PlanetEntryData entry)
    {
        String[] cats = getCategoryRestructionAsArray();
        if (cats == null || cats.length == 0) return true;
        for (int i=0; i<cats.length; i++) 
        {
            if (entry.inCategory(cats[i])) return true;
        }
        return  false;
    }
    
    //------------------------------------------------------------- convenience

    private String[] getCategoryRestructionAsArray()
    {
        if (catArray == null && categoryRestriction != null)
        {
            StringTokenizer toker = new StringTokenizer(categoryRestriction,",");
            catArray = new String[toker.countTokens()];
            int i = 0;
    
            while (toker.hasMoreTokens())
            {
                catArray[i++] = toker.nextToken();
            }
        }
        return catArray;
    }
    /** no-op to please XDoclet generated form */
    private void setCategoryRestructionAsArray(String[] ignored)
    {
    }
    
    //---------------------------------------------------------- implementation

    public void removeSubscription(PlanetSubscriptionData sub)
    {
        Set set = new TreeSet();
        Iterator assocs = getGroupSubscriptionAssocs().iterator();
        PlanetGroupSubscriptionAssoc target = null;
        while (assocs.hasNext())
        {
            PlanetGroupSubscriptionAssoc assoc = 
                    (PlanetGroupSubscriptionAssoc)assocs.next();
            if (assoc.getSubscription().getFeedUrl().equals(sub.getFeedUrl()))
            {
                target = assoc;
                break;
            }
        }
        subscriptionAssocs.remove(target);
    }
    public void addSubscription(PlanetSubscriptionData sub)
    {
        PlanetGroupSubscriptionAssoc assoc = 
                new PlanetGroupSubscriptionAssoc();
        assoc.setGroup(this);
        assoc.setSubscription(sub);
        subscriptionAssocs.add(assoc);
    }
    public void addSubscriptions(Collection subsList)
    {
        Iterator subs = subsList.iterator();
        while (subs.hasNext())
        {
            PlanetSubscriptionData sub = (PlanetSubscriptionData)subs.next();
            addSubscription(sub);
        }
    }
    public Set getSubscriptions() 
    {
        Set set = new TreeSet();
        Iterator assocs = getGroupSubscriptionAssocs().iterator();
        while (assocs.hasNext())
        {
            PlanetGroupSubscriptionAssoc assoc = 
                    (PlanetGroupSubscriptionAssoc)assocs.next();
            set.add(assoc.getSubscription());
        }
        return set;
    }
    public void setData(PersistentObject vo)
    {
        // TODO Auto-generated method stub    
    }
}