View Javadoc

1   /**
2    * Copyright 2005-2006 the original author or authors.
3    *
4    * Licensed under the Gnu General Pubic License, Version 2.0 (the
5    * "License"); you may not use this file except in compliance with
6    * the License. You may obtain a copy of the License at
7    *
8    *      http://www.opensource.org/licenses/gpl-license.php
9    *
10   * This program is distributed in the hope that it will be useful,
11   * but WITHOUT ANY WARRANTY; without even the implied warranty of
12   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13   * See the Gnu General Public License for more details.
14   */
15  package org.figure8.join.businessobjects.artifact.persistence;
16  
17  import org.figure8.join.core.persistence.ObjectDao;
18  import org.figure8.join.businessobjects.commons.Release;
19  import org.figure8.join.businessobjects.artifact.Build;
20  
21  import java.util.List;
22  /**
23   * Data Access interface for Build business objects.
24   * @author  <a href="mailto:laurent.broudoux@free.fr">Laurent Broudoux</a>
25   * @version $Revision: 1.2 $
26   */
27  public interface BuildDao extends ObjectDao{
28  
29     // Public -------------------------------------------------------------------
30     
31     /**
32      * Retrieve all the builds produced for a spcified release
33      * @param release The release to retrieve builds for
34      * @return A list of <code>org.figure8.join.businessobjects.artifact.Build</code>s
35      */
36     public abstract List getBuildsByRelease(Release release);
37     
38     /**
39      * Retrieve builds composed by a specified user
40      * @param userId The unique identifier of the composer
41      * @return A list of <code>org.figure8.join.businessobjects.artifact.Build</code>s
42      */
43     public abstract List getBuildsComposedByUser(String userId);
44  
45     /**
46      * Retrieve builds having the components specified into list
47      * @param components The list of components builds should have
48      * @return A list of <code>org.figure8.join.businessobjects.artifact.Build</code>s
49      */
50     public abstract List getBuildsWithComponents(List components);
51  
52     /**
53      * Retrieve a Build using its unique key identifier
54      * @param key The unique key identifier of build to retrieve
55      * @return The Build corresponding to key or null if no build with this key exists
56      */
57     public abstract Build getBuild(String key);
58  }