View Javadoc
1   /*
2    * Copyright (c) 2002-2020, 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.directories.web;
35  
36  import fr.paris.lutece.plugins.directories.business.Directory;
37  import fr.paris.lutece.plugins.directories.business.DirectoryHome;
38  import fr.paris.lutece.portal.service.message.AdminMessage;
39  import fr.paris.lutece.portal.service.message.AdminMessageService;
40  import fr.paris.lutece.portal.util.mvc.admin.annotations.Controller;
41  import fr.paris.lutece.portal.util.mvc.commons.annotations.Action;
42  import fr.paris.lutece.portal.util.mvc.commons.annotations.View;
43  import fr.paris.lutece.util.url.UrlItem;
44  
45  import java.util.List;
46  import java.util.Map;
47  import javax.servlet.http.HttpServletRequest;
48  
49  /**
50   * This class provides the user interface to manage Directory features ( manage, create, modify, remove )
51   */
52  @Controller( controllerJsp = "ManageDirectories.jsp", controllerPath = "jsp/admin/plugins/directories/", right = "DIRECTORIES_MANAGEMENT" )
53  public class DirectoryJspBean extends AbstractDirectoriesManagerJspBean
54  {
55      private static final long serialVersionUID = -1760898157231830659L;
56      // Templates
57      private static final String TEMPLATE_MANAGE_DIRECTORIES = "/admin/plugins/directories/manage_directories.html";
58      private static final String TEMPLATE_CREATE_DIRECTORY = "/admin/plugins/directories/create_directory.html";
59      private static final String TEMPLATE_MODIFY_DIRECTORY = "/admin/plugins/directories/modify_directory.html";
60  
61      // Parameters
62      private static final String PARAMETER_ID_DIRECTORY = "id_directory";
63  
64      // Properties for page titles
65      private static final String PROPERTY_PAGE_TITLE_MANAGE_DIRECTORIES = "directories.manage_directories.pageTitle";
66      private static final String PROPERTY_PAGE_TITLE_MODIFY_DIRECTORY = "directories.modify_directory.pageTitle";
67      private static final String PROPERTY_PAGE_TITLE_CREATE_DIRECTORY = "directories.create_directory.pageTitle";
68  
69      // Markers
70      private static final String MARK_DIRECTORY_LIST = "directory_list";
71      private static final String MARK_DIRECTORY = "directory";
72  
73      private static final String JSP_MANAGE_DIRECTORIES = "jsp/admin/plugins/directories/ManageDirectories.jsp";
74  
75      // Properties
76      private static final String MESSAGE_CONFIRM_REMOVE_DIRECTORY = "directories.message.confirmRemoveDirectory";
77  
78      // Validations
79      private static final String VALIDATION_ATTRIBUTES_PREFIX = "directories.model.entity.directory.attribute.";
80  
81      // Views
82      private static final String VIEW_MANAGE_DIRECTORIES = "manageDirectories";
83      private static final String VIEW_CREATE_DIRECTORY = "createDirectory";
84      private static final String VIEW_MODIFY_DIRECTORY = "modifyDirectory";
85  
86      // Actions
87      private static final String ACTION_CREATE_DIRECTORY = "createDirectory";
88      private static final String ACTION_MODIFY_DIRECTORY = "modifyDirectory";
89      private static final String ACTION_REMOVE_DIRECTORY = "removeDirectory";
90      private static final String ACTION_CONFIRM_REMOVE_DIRECTORY = "confirmRemoveDirectory";
91  
92      // Infos
93      private static final String INFO_DIRECTORY_CREATED = "directories.info.directory.created";
94      private static final String INFO_DIRECTORY_UPDATED = "directories.info.directory.updated";
95      private static final String INFO_DIRECTORY_REMOVED = "directories.info.directory.removed";
96  
97      // Session variable to store working values
98      private Directory _directory;
99  
100     /**
101      * Build the Manage View
102      * 
103      * @param request
104      *            The HTTP request
105      * @return The page
106      */
107     @View( value = VIEW_MANAGE_DIRECTORIES, defaultView = true )
108     public String getManageDirectories( HttpServletRequest request )
109     {
110         _directory = null;
111         List<Directory> listDirectories = DirectoryHome.getDirectoriesList( );
112         Map<String, Object> model = getPaginatedListModel( request, MARK_DIRECTORY_LIST, listDirectories, JSP_MANAGE_DIRECTORIES );
113 
114         return getPage( PROPERTY_PAGE_TITLE_MANAGE_DIRECTORIES, TEMPLATE_MANAGE_DIRECTORIES, model );
115     }
116 
117     /**
118      * Returns the form to create a directory
119      *
120      * @param request
121      *            The Http request
122      * @return the html code of the directory form
123      */
124     @View( VIEW_CREATE_DIRECTORY )
125     public String getCreateDirectory( HttpServletRequest request )
126     {
127         _directory = ( _directory != null ) ? _directory : new Directory( );
128 
129         Map<String, Object> model = getModel( );
130         model.put( MARK_DIRECTORY, _directory );
131 
132         return getPage( PROPERTY_PAGE_TITLE_CREATE_DIRECTORY, TEMPLATE_CREATE_DIRECTORY, model );
133     }
134 
135     /**
136      * Process the data capture form of a new directory
137      *
138      * @param request
139      *            The Http Request
140      * @return The Jsp URL of the process result
141      */
142     @Action( ACTION_CREATE_DIRECTORY )
143     public String doCreateDirectory( HttpServletRequest request )
144     {
145         populate( _directory, request, request.getLocale( ) );
146 
147         // Check constraints
148         if ( !validateBean( _directory, VALIDATION_ATTRIBUTES_PREFIX ) )
149         {
150             return redirectView( request, VIEW_CREATE_DIRECTORY );
151         }
152 
153         DirectoryHome.create( _directory );
154         addInfo( INFO_DIRECTORY_CREATED, getLocale( ) );
155 
156         return redirectView( request, VIEW_MANAGE_DIRECTORIES );
157     }
158 
159     /**
160      * Manages the removal form of a directory whose identifier is in the http request
161      *
162      * @param request
163      *            The Http request
164      * @return the html code to confirm
165      */
166     @Action( ACTION_CONFIRM_REMOVE_DIRECTORY )
167     public String getConfirmRemoveDirectory( HttpServletRequest request )
168     {
169         int nId = Integer.parseInt( request.getParameter( PARAMETER_ID_DIRECTORY ) );
170         UrlItem url = new UrlItem( getActionUrl( ACTION_REMOVE_DIRECTORY ) );
171         url.addParameter( PARAMETER_ID_DIRECTORY, nId );
172 
173         String strMessageUrl = AdminMessageService.getMessageUrl( request, MESSAGE_CONFIRM_REMOVE_DIRECTORY, url.getUrl( ), AdminMessage.TYPE_CONFIRMATION );
174 
175         return redirect( request, strMessageUrl );
176     }
177 
178     /**
179      * Handles the removal form of a directory
180      *
181      * @param request
182      *            The Http request
183      * @return the jsp URL to display the form to manage directories
184      */
185     @Action( ACTION_REMOVE_DIRECTORY )
186     public String doRemoveDirectory( HttpServletRequest request )
187     {
188         int nId = Integer.parseInt( request.getParameter( PARAMETER_ID_DIRECTORY ) );
189         DirectoryHome.remove( nId );
190         addInfo( INFO_DIRECTORY_REMOVED, getLocale( ) );
191 
192         return redirectView( request, VIEW_MANAGE_DIRECTORIES );
193     }
194 
195     /**
196      * Returns the form to update info about a directory
197      *
198      * @param request
199      *            The Http request
200      * @return The HTML form to update info
201      */
202     @View( VIEW_MODIFY_DIRECTORY )
203     public String getModifyDirectory( HttpServletRequest request )
204     {
205         int nId = Integer.parseInt( request.getParameter( PARAMETER_ID_DIRECTORY ) );
206 
207         if ( _directory == null || ( _directory.getId( ) != nId ) )
208         {
209             _directory = DirectoryHome.findByPrimaryKey( nId );
210         }
211 
212         Map<String, Object> model = getModel( );
213         model.put( MARK_DIRECTORY, _directory );
214 
215         return getPage( PROPERTY_PAGE_TITLE_MODIFY_DIRECTORY, TEMPLATE_MODIFY_DIRECTORY, model );
216     }
217 
218     /**
219      * Process the change form of a directory
220      *
221      * @param request
222      *            The Http request
223      * @return The Jsp URL of the process result
224      */
225     @Action( ACTION_MODIFY_DIRECTORY )
226     public String doModifyDirectory( HttpServletRequest request )
227     {
228         populate( _directory, request, request.getLocale( ) );
229 
230         // Check constraints
231         if ( !validateBean( _directory, VALIDATION_ATTRIBUTES_PREFIX ) )
232         {
233             return redirect( request, VIEW_MODIFY_DIRECTORY, PARAMETER_ID_DIRECTORY, _directory.getId( ) );
234         }
235 
236         DirectoryHome.update( _directory );
237         addInfo( INFO_DIRECTORY_UPDATED, getLocale( ) );
238 
239         return redirectView( request, VIEW_MANAGE_DIRECTORIES );
240     }
241 }