View Javadoc
1   /*
2    * Copyright (c) 2002-2021, 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.contact.web;
35  
36  import fr.paris.lutece.plugins.contact.business.Contact;
37  import fr.paris.lutece.plugins.contact.business.ContactHome;
38  import fr.paris.lutece.plugins.contact.business.ContactListHome;
39  import fr.paris.lutece.portal.service.message.AdminMessage;
40  import fr.paris.lutece.portal.service.message.AdminMessageService;
41  import fr.paris.lutece.portal.service.template.AppTemplateService;
42  import fr.paris.lutece.portal.service.util.AppPropertiesService;
43  import fr.paris.lutece.portal.service.workgroup.AdminWorkgroupService;
44  import fr.paris.lutece.portal.util.mvc.admin.MVCAdminJspBean;
45  import fr.paris.lutece.portal.util.mvc.admin.annotations.Controller;
46  import fr.paris.lutece.portal.util.mvc.commons.annotations.Action;
47  import fr.paris.lutece.portal.util.mvc.commons.annotations.View;
48  import fr.paris.lutece.portal.web.admin.PluginAdminPageJspBean;
49  import fr.paris.lutece.portal.web.constants.Messages;
50  import fr.paris.lutece.portal.web.util.LocalizedPaginator;
51  import fr.paris.lutece.util.ReferenceList;
52  import fr.paris.lutece.util.html.HtmlTemplate;
53  import fr.paris.lutece.util.html.Paginator;
54  import fr.paris.lutece.util.string.StringUtil;
55  import fr.paris.lutece.util.url.UrlItem;
56  
57  import java.util.Collection;
58  import java.util.HashMap;
59  import java.util.List;
60  import java.util.Map;
61  
62  import javax.servlet.http.HttpServletRequest;
63  
64  /**
65   * This class provides the user interface to manage contact features ( manage, create, modify, remove, change order of contact )
66   */
67  @Controller( controllerJsp = "ManageContacts.jsp", controllerPath = "jsp/admin/plugins/contact/", right = ContactJspBean.RIGHT_MANAGE_CONTACT )
68  public class ContactJspBean extends MVCAdminJspBean
69  {
70      ////////////////////////////////////////////////////////////////////////////
71      // Constants
72  
73      // Right
74      public static final String RIGHT_MANAGE_CONTACT = "CONTACT_MANAGEMENT";
75  
76      // parameters
77      private static final String PARAMETER_CONTACT_ID = "id_contact";
78      private static final String PARAMETER_CONTACT_NAME = "contact_name";
79      private static final String PARAMETER_CONTACT_EMAIL = "contact_email";
80      private static final String PARAMETER_ID_CONTACT_LIST = "id_contact_list";
81      private static final String PARAMETER_CONTACT_WORKGROUP = "workgroup";
82      private static final String PARAMETER_PAGE_INDEX = "page_index";
83  
84      // templates
85      private static final String TEMPLATE_CONTACTS = "/admin/plugins/contact/manage_contacts.html";
86      private static final String TEMPLATE_CREATE_CONTACT = "/admin/plugins/contact/create_contact.html";
87      private static final String TEMPLATE_MODIFY_CONTACT = "/admin/plugins/contact/modify_contact.html";
88      private static final String TEMPLATE_HOME = "/admin/plugins/contact/manage_contacts_home.html";
89  
90      // properties for page titles
91      private static final String PROPERTY_PAGE_TITLE_CONTACTS = "contact.manage_contacts.pageTitle";
92      private static final String PROPERTY_PAGE_TITLE_MODIFY = "contact.modify_contact.pageTitle";
93      private static final String PROPERTY_PAGE_TITLE_CREATE = "contact.create_contact.pageTitle";
94      private static final String PROPERTY_PAGE_TITLE_FEATURES = "contact.manage_features.pageTitle";
95  
96      // Markers
97      private static final String MARK_CONTACT_LIST = "contact_list";
98      private static final String MARK_WORKGROUPS_LIST = "workgroups_list";
99      private static final String MARK_CONTACT = "contact";
100     private static final String MARK_PAGINATOR = "paginator";
101     private static final String MARK_NB_ITEMS_PER_PAGE = "nb_items_per_page";
102 
103     // Properties
104     private static final String PROPERTY_DEFAULT_LIST_CONTACT_PER_PAGE = "contact.listContacts.itemsPerPage";
105 
106     // Messages
107     private static final String MESSAGE_CONFIRM_REMOVE_CONTACT = "contact.message.confirmRemoveContact";
108     private static final String MESSAGE_EMAIL_NOT_VALID = "contact.message.emailNotValid";
109     private static final String MESSAGE_CONTACT_STILL_ASSIGNED = "contact.message.ContactStillAssigned";
110 
111     // Views
112     private static final String VIEW_CREATE_CONTACT = "viewCreateContact";
113     private static final String VIEW_MODIFY_CONTACT = "viewModifyContact";
114     private static final String VIEW_MANAGE_CONTACTS = "viewManageContacts";
115     private static final String VIEW_CONFIRM_REMOVE_CONTACT = "viewConfirmRemoveContact";
116 
117     // Actions
118     private static final String ACTION_CREATE_CONTACT = "actionCreateContact";
119     private static final String ACTION_MODIFY_CONTACT = "actionModifyContact";
120     private static final String ACTION_REMOVE_CONTACT = "actionRemoveContact";
121 
122     // Variables
123     private int _nDefaultItemsPerPage;
124     private String _strCurrentPageIndex;
125     private int _nItemsPerPage;
126 
127     /**
128      * returns the template, with the 2 features: contacts, and contactList
129      * 
130      * @param request
131      *            the HttpRequest
132      * @return template model
133      */
134     public String getManageContactsHome( HttpServletRequest request )
135     {
136         setPageTitleProperty( PROPERTY_PAGE_TITLE_FEATURES );
137 
138         HashMap rootModel = new HashMap( );
139         HtmlTemplate templateList = AppTemplateService.getTemplate( TEMPLATE_HOME, getLocale( ), rootModel );
140 
141         return getAdminPage( templateList.getHtml( ) );
142     }
143 
144     /**
145      * Returns the list of people to contact by email
146      * 
147      * @param request
148      *            The Http request
149      * @return the contacts list
150      */
151     @View( value = VIEW_MANAGE_CONTACTS, defaultView = true )
152     public String getManageContacts( HttpServletRequest request )
153     {
154         _strCurrentPageIndex = Paginator.getPageIndex( request, Paginator.PARAMETER_PAGE_INDEX, _strCurrentPageIndex );
155         _nDefaultItemsPerPage = AppPropertiesService.getPropertyInt( PROPERTY_DEFAULT_LIST_CONTACT_PER_PAGE, 50 );
156         _nItemsPerPage = Paginator.getItemsPerPage( request, Paginator.PARAMETER_ITEMS_PER_PAGE, _nItemsPerPage, _nDefaultItemsPerPage );
157 
158         Collection<Contact> listContacts = ContactHome.findAll( getPlugin( ) );
159         listContacts = AdminWorkgroupService.getAuthorizedCollection( listContacts, getUser( ) );
160 
161         LocalizedPaginator paginator = new LocalizedPaginator( (List<Contact>) listContacts, _nItemsPerPage, getViewUrl( VIEW_MANAGE_CONTACTS ),
162                 PARAMETER_PAGE_INDEX, _strCurrentPageIndex, getLocale( ) );
163 
164         Map<String, Object> model = new HashMap<String, Object>( );
165 
166         model.put( MARK_NB_ITEMS_PER_PAGE, "" + _nItemsPerPage );
167         model.put( MARK_PAGINATOR, paginator );
168         model.put( MARK_CONTACT_LIST, paginator.getPageItems( ) );
169 
170         return getPage( PROPERTY_PAGE_TITLE_CONTACTS, TEMPLATE_CONTACTS, model );
171     }
172 
173     /**
174      * Returns the form to create a contact
175      * 
176      * @param request
177      *            The Http request
178      * @return the html code of the contact form
179      */
180     @View( VIEW_CREATE_CONTACT )
181     public String getCreateContact( HttpServletRequest request )
182     {
183         Map<String, Object> model = new HashMap<String, Object>( );
184         ReferenceList workgroupsList = AdminWorkgroupService.getUserWorkgroups( getUser( ), getLocale( ) );
185         model.put( MARK_WORKGROUPS_LIST, workgroupsList );
186 
187         return getPage( PROPERTY_PAGE_TITLE_CREATE, TEMPLATE_CREATE_CONTACT, model );
188     }
189 
190     /**
191      * Process the data capture form of a new contact
192      * 
193      * @param request
194      *            The Http Request
195      * @return The Jsp URL of the process result
196      */
197     @Action( ACTION_CREATE_CONTACT )
198     public String doCreateContact( HttpServletRequest request )
199     {
200         Contactcontact/business/Contact.html#Contact">Contact contact = new Contact( );
201         contact.setName( request.getParameter( PARAMETER_CONTACT_NAME ) );
202         contact.setEmail( request.getParameter( PARAMETER_CONTACT_EMAIL ) );
203         contact.setWorkgroup( request.getParameter( PARAMETER_CONTACT_WORKGROUP ) );
204 
205         // Mandatory fields
206         if ( request.getParameter( PARAMETER_CONTACT_NAME ).equals( "" ) || request.getParameter( PARAMETER_CONTACT_EMAIL ).equals( "" ) )
207         {
208             return redirect( request, AdminMessageService.getMessageUrl( request, Messages.MANDATORY_FIELDS, AdminMessage.TYPE_STOP ) );
209         }
210 
211         else
212             if ( !StringUtil.checkEmail( request.getParameter( PARAMETER_CONTACT_EMAIL ) ) )
213             {
214                 return redirect( request, AdminMessageService.getMessageUrl( request, MESSAGE_EMAIL_NOT_VALID, AdminMessage.TYPE_STOP ) );
215             }
216 
217         ContactHome.create( contact, getPlugin( ) );
218 
219         // if the operation occurred well, redirects towards the list of the Contacts
220         return redirectView( request, VIEW_MANAGE_CONTACTS );
221     }
222 
223     /**
224      * Returns the form to update info about a contact
225      * 
226      * @param request
227      *            The Http request
228      * @return The HTML form to update info
229      */
230     @View( VIEW_MODIFY_CONTACT )
231     public String getModifyContact( HttpServletRequest request )
232     {
233         int nId = Integer.parseInt( request.getParameter( PARAMETER_CONTACT_ID ) );
234         Contact contact = ContactHome.findByPrimaryKey( nId, getPlugin( ) );
235 
236         if ( contact == null )
237         {
238             return getManageContacts( request );
239         }
240 
241         Map<String, Object> model = new HashMap<String, Object>( );
242         ReferenceList workgroupsList = AdminWorkgroupService.getUserWorkgroups( getUser( ), getLocale( ) );
243         model.put( MARK_WORKGROUPS_LIST, workgroupsList );
244         model.put( MARK_CONTACT, contact );
245 
246         return getPage( PROPERTY_PAGE_TITLE_MODIFY, TEMPLATE_MODIFY_CONTACT, model );
247     }
248 
249     /**
250      * Process the change form of a contact
251      * 
252      * @param request
253      *            The Http request
254      * @return The Jsp URL of the process result
255      */
256     @Action( ACTION_MODIFY_CONTACT )
257     public String doModifyContact( HttpServletRequest request )
258     {
259         // Mandatory fields
260         if ( request.getParameter( PARAMETER_CONTACT_NAME ).equals( "" ) || request.getParameter( PARAMETER_CONTACT_EMAIL ).equals( "" ) )
261         {
262             return redirect( request, AdminMessageService.getMessageUrl( request, Messages.MANDATORY_FIELDS, AdminMessage.TYPE_STOP ) );
263         }
264         else
265             if ( !StringUtil.checkEmail( request.getParameter( PARAMETER_CONTACT_EMAIL ) ) )
266             {
267                 return redirect( request, AdminMessageService.getMessageUrl( request, MESSAGE_EMAIL_NOT_VALID, AdminMessage.TYPE_STOP ) );
268             }
269 
270         int nId = Integer.parseInt( request.getParameter( PARAMETER_CONTACT_ID ) );
271         Contact contact = ContactHome.findByPrimaryKey( nId, getPlugin( ) );
272         contact.setName( request.getParameter( PARAMETER_CONTACT_NAME ) );
273         contact.setEmail( request.getParameter( PARAMETER_CONTACT_EMAIL ) );
274         contact.setWorkgroup( request.getParameter( PARAMETER_CONTACT_WORKGROUP ) );
275         ContactHome.update( contact, getPlugin( ) );
276 
277         // if the operation occurred well, redirects towards the list of the Contacts
278         return redirectView( request, VIEW_MANAGE_CONTACTS );
279     }
280 
281     /**
282      * Manages the removal form of a contact whose identifier is in the http request
283      * 
284      * @param request
285      *            The Http request
286      * @return the html code to confirm
287      */
288     @View( VIEW_CONFIRM_REMOVE_CONTACT )
289     public String getConfirmRemoveContact( HttpServletRequest request )
290     {
291         int nIdContact = Integer.parseInt( request.getParameter( PARAMETER_CONTACT_ID ) );
292 
293         if ( ContactListHome.countListsForContact( nIdContact, getPlugin( ) ) > 0 )
294         {
295             UrlItem url = new UrlItem( getViewUrl( VIEW_MANAGE_CONTACTS ) );
296 
297             return redirect( request, AdminMessageService.getMessageUrl( request, MESSAGE_CONTACT_STILL_ASSIGNED, url.getUrl( ), AdminMessage.TYPE_STOP ) );
298         }
299 
300         UrlItem url = new UrlItem( getActionUrl( ACTION_REMOVE_CONTACT ) );
301         url.addParameter( PARAMETER_CONTACT_ID, nIdContact );
302         url.addParameter( PARAMETER_ID_CONTACT_LIST, request.getParameter( PARAMETER_ID_CONTACT_LIST ) );
303 
304         return redirect( request, AdminMessageService.getMessageUrl( request, MESSAGE_CONFIRM_REMOVE_CONTACT, url.getUrl( ), AdminMessage.TYPE_CONFIRMATION ) );
305 
306     }
307 
308     /**
309      * Treats the removal form of a contact
310      * 
311      * @param request
312      *            The Http request
313      * @return the jsp URL to display the form to manage contacts
314      */
315     @Action( ACTION_REMOVE_CONTACT )
316     public String doRemoveContact( HttpServletRequest request )
317     {
318         int nIdContact = Integer.parseInt( request.getParameter( PARAMETER_CONTACT_ID ) );
319 
320         Contact contact = ContactHome.findByPrimaryKey( nIdContact, getPlugin( ) );
321 
322         ContactListHome.unassignListsForContact( contact.getId( ), getPlugin( ) );
323         ContactHome.remove( contact, getPlugin( ) );
324         ContactListHome.unassignListsForContact( nIdContact, getPlugin( ) );
325 
326         // if the operation occurred well, redirects towards the list of the Contacts
327         return redirectView( request, VIEW_MANAGE_CONTACTS );
328     }
329 }