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          try ( DAOUtil daoUtil = new DAOUtil( SQL_QUERY_INSERT ) )
62          {
63              daoUtil.setInt( 1, historyEvent.getIdDocument( ) );
64              daoUtil.setTimestamp( 2, historyEvent.getDate( ) );
65              daoUtil.setString( 3, historyEvent.getEventUser( ) );
66              daoUtil.setString( 4, historyEvent.getEventMessageKey( ) );
67              daoUtil.setString( 5, historyEvent.getDocumentStateKey( ) );
68              daoUtil.setString( 6, historyEvent.getSpace( ) );
69  
70              daoUtil.executeUpdate( );
71          }
72      }
73  
74      /**
75       * Delete a record from the table
76       *
77       * @param nDocumentId
78       *            The id of the document
79       */
80      public void delete( int nDocumentId )
81      {
82          try ( DAOUtil daoUtil = new DAOUtil( SQL_QUERY_DELETE ) )
83          {
84              daoUtil.setInt( 1, nDocumentId );
85  
86              daoUtil.executeUpdate( );
87          }
88      }
89  
90      /**
91       * Load the list of historyEvents
92       *
93       * @return The Collection of the HistoryEvents
94       * @param nDocumentId
95       *            The document Id
96       */
97      public List<HistoryEvent> selectEventListByDocument( int nDocumentId )
98      {
99          List<HistoryEvent> listHistoryEvents = new ArrayList<>( );
100         try ( DAOUtil daoUtil = new DAOUtil( SQL_QUERY_SELECT_BY_DOCUMENT ) )
101         {
102             daoUtil.setInt( 1, nDocumentId );
103             daoUtil.executeQuery( );
104 
105             while ( daoUtil.next( ) )
106             {
107                 HistoryEventdocument/business/history/HistoryEvent.html#HistoryEvent">HistoryEvent event = new HistoryEvent( );
108                 event.setIdDocument( daoUtil.getInt( 1 ) );
109                 event.setDate( daoUtil.getTimestamp( 2 ) );
110                 event.setEventUser( daoUtil.getString( 3 ) );
111                 event.setEventMessageKey( daoUtil.getString( 4 ) );
112                 event.setDocumentStateKey( daoUtil.getString( 5 ) );
113                 event.setSpace( daoUtil.getString( 6 ) );
114 
115                 listHistoryEvents.add( event );
116             }
117         }
118         return listHistoryEvents;
119     }
120 
121     /**
122      * Load the list of historyEvents
123      *
124      * @return The Collection of the HistoryEvents
125      * @param strUserId
126      *            The UserId
127      */
128     public Collection<HistoryEvent> selectEventListByUser( String strUserId )
129     {
130         Collection<HistoryEvent> listHistoryEvents = new ArrayList<>( );
131         try ( DAOUtil daoUtil = new DAOUtil( SQL_QUERY_SELECT_BY_USER ) )
132         {
133             daoUtil.setString( 1, strUserId );
134             daoUtil.executeQuery( );
135 
136             while ( daoUtil.next( ) )
137             {
138                 HistoryEventdocument/business/history/HistoryEvent.html#HistoryEvent">HistoryEvent event = new HistoryEvent( );
139                 event.setIdDocument( daoUtil.getInt( 1 ) );
140                 event.setDate( daoUtil.getTimestamp( 2 ) );
141                 event.setEventUser( daoUtil.getString( 3 ) );
142                 event.setEventMessageKey( daoUtil.getString( 4 ) );
143                 event.setDocumentStateKey( daoUtil.getString( 5 ) );
144                 event.setSpace( daoUtil.getString( 6 ) );
145 
146                 listHistoryEvents.add( event );
147             }
148         }
149         return listHistoryEvents;
150     }
151 }