View Javadoc
1   /*
2    * Copyright (c) 2002-2023, City of Paris
3    * All rights reserved.
4    *
5    * Redistribution and use in source and binary forms, with or without
6    * modification, are permitted provided that the following conditions
7    * are met:
8    *
9    *  1. Redistributions of source code must retain the above copyright notice
10   *     and the following disclaimer.
11   *
12   *  2. Redistributions in binary form must reproduce the above copyright notice
13   *     and the following disclaimer in the documentation and/or other materials
14   *     provided with the distribution.
15   *
16   *  3. Neither the name of 'Mairie de Paris' nor 'Lutece' nor the names of its
17   *     contributors may be used to endorse or promote products derived from
18   *     this software without specific prior written permission.
19   *
20   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
21   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23   * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
24   * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25   * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26   * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27   * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28   * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30   * POSSIBILITY OF SUCH DAMAGE.
31   *
32   * License 1.0
33   */
34  package fr.paris.lutece.plugins.document.business.history;
35  
36  import fr.paris.lutece.util.sql.DAOUtil;
37  
38  import java.util.ArrayList;
39  import java.util.Collection;
40  import java.util.List;
41  
42  /**
43   * This class provides Data Access methods for HistoryEvent objects
44   */
45  public final class HistoryEventDAO implements IHistoryEventDAO
46  {
47      // Constants
48      private static final String SQL_QUERY_INSERT = " INSERT INTO document_history ( id_document, event_date, event_user, event_message_key, document_state_key, document_space ) VALUES ( ?, ?, ?, ?, ?, ? ) ";
49      private static final String SQL_QUERY_DELETE = " DELETE FROM document_history WHERE id_document = ?  ";
50      private static final String SQL_QUERY_SELECT_BY_DOCUMENT = " SELECT id_document, event_date, event_user, event_message_key, document_state_key, document_space FROM document_history WHERE id_document = ? ";
51      private static final String SQL_QUERY_SELECT_BY_USER = " SELECT id_document, event_date, event_user, event_message_key, document_state_key, document_space FROM document_history WHERE event_user = ? ";
52  
53      /**
54       * Insert a new record in the table.
55       *
56       * @param historyEvent
57       *            The historyEvent object
58       */
59      public void insert( HistoryEvent historyEvent )
60      {
61          DAOUtil daoUtil = new DAOUtil( SQL_QUERY_INSERT );
62          daoUtil.setInt( 1, historyEvent.getIdDocument( ) );
63          daoUtil.setTimestamp( 2, historyEvent.getDate( ) );
64          daoUtil.setString( 3, historyEvent.getEventUser( ) );
65          daoUtil.setString( 4, historyEvent.getEventMessageKey( ) );
66          daoUtil.setString( 5, historyEvent.getDocumentStateKey( ) );
67          daoUtil.setString( 6, historyEvent.getSpace( ) );
68  
69          daoUtil.executeUpdate( );
70          daoUtil.free( );
71      }
72  
73      /**
74       * Delete a record from the table
75       *
76       * @param nDocumentId
77       *            The id of the document
78       */
79      public void delete( int nDocumentId )
80      {
81          DAOUtil daoUtil = new DAOUtil( SQL_QUERY_DELETE );
82          daoUtil.setInt( 1, nDocumentId );
83  
84          daoUtil.executeUpdate( );
85          daoUtil.free( );
86      }
87  
88      /**
89       * Load the list of historyEvents
90       *
91       * @return The Collection of the HistoryEvents
92       * @param nDocumentId
93       *            The document Id
94       */
95      public List<HistoryEvent> selectEventListByDocument( int nDocumentId )
96      {
97          List<HistoryEvent> listHistoryEvents = new ArrayList<HistoryEvent>( );
98          DAOUtil daoUtil = new DAOUtil( SQL_QUERY_SELECT_BY_DOCUMENT );
99          daoUtil.setInt( 1, nDocumentId );
100         daoUtil.executeQuery( );
101 
102         while ( daoUtil.next( ) )
103         {
104             HistoryEventdocument/business/history/HistoryEvent.html#HistoryEvent">HistoryEvent event = new HistoryEvent( );
105             event.setIdDocument( daoUtil.getInt( 1 ) );
106             event.setDate( daoUtil.getTimestamp( 2 ) );
107             event.setEventUser( daoUtil.getString( 3 ) );
108             event.setEventMessageKey( daoUtil.getString( 4 ) );
109             event.setDocumentStateKey( daoUtil.getString( 5 ) );
110             event.setSpace( daoUtil.getString( 6 ) );
111 
112             listHistoryEvents.add( event );
113         }
114 
115         daoUtil.free( );
116 
117         return listHistoryEvents;
118     }
119 
120     /**
121      * Load the list of historyEvents
122      *
123      * @return The Collection of the HistoryEvents
124      * @param strUserId
125      *            The UserId
126      */
127     public Collection<HistoryEvent> selectEventListByUser( String strUserId )
128     {
129         Collection<HistoryEvent> listHistoryEvents = new ArrayList<HistoryEvent>( );
130         DAOUtil daoUtil = new DAOUtil( SQL_QUERY_SELECT_BY_USER );
131         daoUtil.setString( 1, strUserId );
132         daoUtil.executeQuery( );
133 
134         while ( daoUtil.next( ) )
135         {
136             HistoryEventdocument/business/history/HistoryEvent.html#HistoryEvent">HistoryEvent event = new HistoryEvent( );
137             event.setIdDocument( daoUtil.getInt( 1 ) );
138             event.setDate( daoUtil.getTimestamp( 2 ) );
139             event.setEventUser( daoUtil.getString( 3 ) );
140             event.setEventMessageKey( daoUtil.getString( 4 ) );
141             event.setDocumentStateKey( daoUtil.getString( 5 ) );
142             event.setSpace( daoUtil.getString( 6 ) );
143 
144             listHistoryEvents.add( event );
145         }
146 
147         daoUtil.free( );
148 
149         return listHistoryEvents;
150     }
151 }