source: gli/branches/rtl-gli/src/org/greenstone/gatherer/cdm/GeneralManager.java@ 18368

Last change on this file since 18368 was 18352, checked in by kjdon, 15 years ago

updated the rtl-gli branch with files from trunk. Result of a merge 14807:18318
  • Property svn:keywords set to Author Date Id Revision
File size: 18.1 KB
Line 
1/**
2 *#########################################################################
3 *
4 * A component of the Gatherer application, part of the Greenstone digital
5 * library suite from the New Zealand Digital Library Project at the
6 * University of Waikato, New Zealand.
7 *
8 * Author: John Thompson, Greenstone Digital Library, University of Waikato
9 *
10 * Copyright (C) 1999 New Zealand Digital Library Project
11 *
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
16 *
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
21 *
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 *########################################################################
26 */
27package org.greenstone.gatherer.cdm;
28
29import java.awt.*;
30import java.awt.event.*;
31import java.io.*;
32import java.util.regex.*;
33import javax.swing.*;
34import javax.swing.filechooser.*;
35import javax.swing.event.*;
36import org.greenstone.gatherer.Configuration;
37import org.greenstone.gatherer.DebugStream;
38import org.greenstone.gatherer.Dictionary;
39import org.greenstone.gatherer.Gatherer;
40import org.greenstone.gatherer.collection.CollectionManager;
41import org.greenstone.gatherer.gui.DesignPaneHeader;
42import org.greenstone.gatherer.gui.EmailField;
43import org.greenstone.gatherer.gui.GLIButton;
44import org.greenstone.gatherer.gui.GUIUtils;
45import org.greenstone.gatherer.remote.RemoteGreenstoneServer;
46import org.greenstone.gatherer.util.StaticStrings;
47import org.greenstone.gatherer.Gatherer;
48
49/** This class provides a graphical interface for editing general metadata for the collection, such as name, description, icons etc.
50*/
51public class GeneralManager {
52
53 /** The controls used to modify the general options. */
54 private Control controls;
55 /** Constructor. */
56 public GeneralManager() {
57 }
58
59 /** Destructor. */
60 public void destroy() {
61 if (controls != null) {
62 controls.destroy();
63 controls = null;
64 }
65 }
66
67 public void loseFocus() {
68 }
69
70 public void gainFocus() {
71
72 }
73 /** This class is resposible for generating the controls for the editing of general options.
74 * @return the Control for editing the general options
75 */
76 public Control getControls() {
77 if (controls == null) {
78 controls = new GeneralControl();
79 }
80 return controls;
81 }
82
83
84 /** Called when the detail mode has changed which in turn may cause several design elements to be available/hidden
85 * @param mode the new mode as an int
86 */
87 public void modeChanged(int mode) {
88
89 }
90
91 /** This class represents the visual component of the general options stored in the CollectionDesignManager. */
92 private class GeneralControl
93 extends JPanel
94 implements Control {
95
96 private boolean ready = false;
97 private CollectionMeta collection_extra_collectionmeta;
98 private CollectionMeta collection_name_collectionmeta;
99 private CollectionMeta creator_collectionmeta;
100 private CollectionMeta icon_collection_collectionmeta;
101 private CollectionMeta icon_collection_small_collectionmeta;
102 private CollectionMeta maintainer_collectionmeta;
103 private CollectionMeta public_collectionmeta;
104 /** The creators email. */
105 private EmailField creator_emailfield;
106 /** The maintainers email. */
107 private EmailField maintainer_emailfield;
108 /** Button to browse for the collection about page icon. */
109 private JButton browse_about_icon_button;
110 /** Button to browse for the collection home page icon. */
111 private JButton browse_home_icon_button;
112 /** The checkbox controlling public access to the collection. */
113 private JCheckBox public_checkbox;
114 private JLabel creator_label;
115 private JLabel description_label;
116 private JLabel icon_label;
117 private JLabel maintainer_label;
118 private JLabel name_label;
119 private JLabel small_icon_label;
120 /** The text field used to edit the file name of the collections icon. */
121 private JTextField icon_textfield;
122 /** The text field used to edit the collections title. */
123 private JTextField name_textfield;
124 /** The text field used to edit the file name of the collections small icon. */
125 private JTextField small_icon_textfield;
126 /** A text area used to modify the collection description. */
127 private JTextArea description_textarea;
128 /** Constructor. */
129 public GeneralControl() {
130 super();
131 // Retrieve some of the model elements, those we know aren't language dependant
132 public_collectionmeta = new CollectionMeta(CollectionDesignManager.collect_config.getPublic());
133
134 // Creation
135 JPanel header_panel = new DesignPaneHeader("CDM.GUI.General", "generalsettings");
136
137 JPanel all_details_panel = new JPanel();
138 JPanel details_panel = new JPanel();
139 JPanel fields_panel = new JPanel();
140
141 creator_label = new JLabel(Dictionary.get("CDM.General.Email.Creator"));
142
143 creator_emailfield = new EmailField(Configuration.getColor("coloring.error_background", false));
144 creator_emailfield.setToolTipText(Dictionary.get("CDM.General.Email.Creator_Tooltip"));
145
146 maintainer_label = new JLabel(Dictionary.get("CDM.General.Email.Maintainer"));
147
148 maintainer_emailfield = new EmailField(Configuration.getColor("coloring.error_background", false));
149 maintainer_emailfield.setToolTipText(Dictionary.get("CDM.General.Email.Maintainer_Tooltip"));
150
151 name_label = new JLabel(Dictionary.get("CDM.General.Collection_Name"));
152 name_textfield = new JTextField();
153 name_textfield.setToolTipText(Dictionary.get("CDM.General.Collection_Name_Tooltip"));
154
155 JLabel short_name_label = new JLabel(Dictionary.get("NewCollectionPrompt.Collection_Name"));
156 JTextField short_name_textfield = new JTextField(CollectionManager.getLoadedCollectionName());
157 short_name_textfield.setEditable(false);
158 short_name_textfield.setBackground(Configuration.getColor("coloring.collection_tree_background", false));
159 JPanel icon_panel = new JPanel();
160 icon_label = new JLabel(Dictionary.get("CDM.General.Icon_Collection"));
161 icon_textfield = new JTextField();
162 icon_textfield.setToolTipText(Dictionary.get("CDM.General.Icon_Collection_Tooltip"));
163 browse_about_icon_button = new GLIButton(Dictionary.get("General.Browse"));
164 JPanel small_icon_panel = new JPanel();
165 small_icon_label = new JLabel(Dictionary.get("CDM.General.Icon_Collection_Small"));
166 small_icon_textfield = new JTextField();
167 small_icon_textfield.setToolTipText(Dictionary.get("CDM.General.Icon_Collection_Small_Tooltip"));
168 browse_home_icon_button = new GLIButton(Dictionary.get("General.Browse"));
169
170 // public
171 JPanel box_panel = new JPanel();
172 public_checkbox = new JCheckBox(Dictionary.get("CDM.General.Access"), public_collectionmeta.getValue(CollectionMeta.TEXT).equals(StaticStrings.TRUE_STR));
173
174 JPanel description_panel = new JPanel();
175 description_label = new JLabel(Dictionary.get("CDM.General.Collection_Extra"));
176
177 description_textarea = new JTextArea();
178 description_textarea.setBackground(Configuration.getColor("coloring.editable_background", false));
179 description_textarea.setToolTipText(Dictionary.get("CDM.General.Collection_Extra_Tooltip"));
180
181 // Connection
182 BrowseListener browse_listener = new BrowseListener(StaticStrings.IMAGES_PATH_RELATIVE_TO_GSDL_PREFIX);
183 browse_about_icon_button.addActionListener(browse_listener);
184 browse_home_icon_button.addActionListener(browse_listener);
185 browse_listener = null;
186 public_checkbox.addActionListener(CollectionDesignManager.change_listener);
187 creator_emailfield.getDocument().addDocumentListener(CollectionDesignManager.change_listener);
188 description_textarea.getDocument().addDocumentListener(CollectionDesignManager.change_listener);
189 icon_textfield.getDocument().addDocumentListener(CollectionDesignManager.change_listener);
190 maintainer_emailfield.getDocument().addDocumentListener(CollectionDesignManager.change_listener);
191 name_textfield.getDocument().addDocumentListener(CollectionDesignManager.change_listener);
192 name_textfield.getDocument().addDocumentListener(new CollectionTitleUpdater());
193 small_icon_textfield.getDocument().addDocumentListener(CollectionDesignManager.change_listener);
194
195 // Layout
196 fields_panel.setBorder(BorderFactory.createEmptyBorder(5,0,0,0));
197 fields_panel.setLayout(new BorderLayout(5,2));
198
199 JPanel fields_label_panel = new JPanel();
200 fields_label_panel.setLayout(new GridLayout(6,1));
201
202 JPanel fields_box_panel = new JPanel();
203 fields_box_panel.setLayout(new GridLayout(6,1));
204
205 // creator
206 fields_label_panel.add(creator_label);
207 fields_box_panel.add(creator_emailfield);
208
209 // maintainer
210 fields_label_panel.add(maintainer_label);
211 fields_box_panel.add(maintainer_emailfield);
212
213 // title
214 fields_label_panel.add(name_label);
215 fields_box_panel.add(name_textfield);
216
217 // collection short name
218 fields_label_panel.add(short_name_label);
219 fields_box_panel.add(short_name_textfield);
220
221 // icon
222 fields_label_panel.add(icon_label);
223 fields_box_panel.add(icon_panel);
224
225 // small icon
226 fields_label_panel.add(small_icon_label);
227 fields_box_panel.add(small_icon_panel);
228
229 fields_panel.add(fields_label_panel, BorderLayout.WEST);
230 fields_panel.add(fields_box_panel, BorderLayout.CENTER);
231
232 icon_panel.setLayout(new BorderLayout());
233 icon_panel.add(icon_textfield, BorderLayout.CENTER);
234 icon_panel.add(browse_about_icon_button, BorderLayout.EAST);
235
236 small_icon_panel.setLayout(new BorderLayout());
237 small_icon_panel.add(small_icon_textfield, BorderLayout.CENTER);
238 small_icon_panel.add(browse_home_icon_button, BorderLayout.EAST);
239
240 box_panel.setLayout(new GridLayout(1,1,5,2));
241 box_panel.add(public_checkbox);
242
243 description_panel.setLayout(new BorderLayout());
244 description_panel.add(description_label, BorderLayout.NORTH);
245 description_panel.add(new JScrollPane(description_textarea), BorderLayout.CENTER);
246
247 details_panel.setLayout(new BorderLayout());
248 details_panel.add(fields_panel, BorderLayout.NORTH);
249 details_panel.add(box_panel, BorderLayout.CENTER);
250
251 all_details_panel.setLayout(new BorderLayout());
252 all_details_panel.add(details_panel, BorderLayout.NORTH);
253 all_details_panel.add(description_panel, BorderLayout.CENTER);
254
255 setBorder(BorderFactory.createEmptyBorder(0,5,0,0));
256 setLayout(new BorderLayout());
257 add(header_panel, BorderLayout.NORTH);
258 add(all_details_panel, BorderLayout.CENTER);
259 }
260
261 /** Destructor. */
262 public void destroy() {
263 }
264
265 /** Called to refresh the components. */
266 public void gainFocus() {
267 // Retrieve all of the elements that are dependant on default language.
268 collection_extra_collectionmeta = CollectionDesignManager.collectionmeta_manager.getMetadatum(StaticStrings.COLLECTIONMETADATA_COLLECTIONEXTRA_STR);
269 collection_name_collectionmeta = CollectionDesignManager.collectionmeta_manager.getMetadatum(StaticStrings.COLLECTIONMETADATA_COLLECTIONNAME_STR);
270
271 creator_collectionmeta = new CollectionMeta(CollectionDesignManager.collect_config.getCreator());
272 icon_collection_collectionmeta = CollectionDesignManager.collectionmeta_manager.getMetadatum(StaticStrings.COLLECTIONMETADATA_ICONCOLLECTION_STR);
273 icon_collection_small_collectionmeta = CollectionDesignManager.collectionmeta_manager.getMetadatum(StaticStrings.COLLECTIONMETADATA_ICONCOLLECTIONSMALL_STR);
274 maintainer_collectionmeta = new CollectionMeta(CollectionDesignManager.collect_config.getMaintainer());
275 // Make sure the components are up to date
276 creator_emailfield.setText(creator_collectionmeta.getValue(CollectionMeta.TEXT));
277 creator_emailfield.setCaretPosition(0);
278 description_textarea.setText(collection_extra_collectionmeta.getValue(CollectionMeta.TEXT));
279 description_textarea.setCaretPosition(0);
280 icon_textfield.setText(icon_collection_collectionmeta.getValue(CollectionMeta.TEXT));
281 icon_textfield.setCaretPosition(0);
282 maintainer_emailfield.setText(maintainer_collectionmeta.getValue(CollectionMeta.TEXT));
283 maintainer_emailfield.setCaretPosition(0);
284 name_textfield.setText(collection_name_collectionmeta.getValue(CollectionMeta.TEXT));
285 name_textfield.setCaretPosition(0);
286 small_icon_textfield.setText(icon_collection_small_collectionmeta.getValue(CollectionMeta.TEXT));
287 small_icon_textfield.setCaretPosition(0);
288 public_checkbox.setSelected(public_collectionmeta.getValue(CollectionMeta.TEXT).equals(StaticStrings.TRUE_STR));
289 ready = true;
290 }
291
292 /** Called to store the current value of the components. */
293 public void loseFocus() {
294 // String values. Have to test if this component has actually ever recieved focus anyway.
295
296 if (!ready) return;
297
298 public_collectionmeta.setValue((public_checkbox.isSelected() ? StaticStrings.TRUE_STR : StaticStrings.FALSE_STR));
299 String creator_email_str = creator_emailfield.getText();
300 creator_collectionmeta.setValue(creator_email_str);
301 collection_extra_collectionmeta.setValue(description_textarea.getText());
302 icon_collection_collectionmeta.setValue(icon_textfield.getText());
303 maintainer_collectionmeta.setValue(maintainer_emailfield.getText());
304 icon_collection_small_collectionmeta.setValue(small_icon_textfield.getText());
305 collection_name_collectionmeta.setValue(name_textfield.getText());
306
307
308 }
309
310 /** Listens for a click on either browse button, and when detected opens a file browser window initially pointed at the images folder of the collection. Once a user has selected a path, does it's best to construct the best address to the resource, such as _httpcollection_/images/about.gif */
311 private class BrowseListener
312 implements ActionListener {
313
314 private String prefix;
315
316 public BrowseListener(String prefix_raw) {
317 this.prefix = prefix_raw.replaceAll(StaticStrings.COLNAME_PATTERN, CollectionManager.getLoadedCollectionName());
318 }
319
320 public void actionPerformed(ActionEvent event) {
321 // Open an almost standard file browser to the images folder of the current collection
322 File images_folder = new File(CollectionManager.getLoadedCollectionImagesDirectoryPath());
323 // If images isn't already there, create it
324 if(!images_folder.exists()) {
325 images_folder.mkdirs();
326 }
327 JFileChooser file_chooser = new JFileChooser(images_folder);
328 file_chooser.setAcceptAllFileFilterUsed(false);
329 file_chooser.setDialogTitle(Dictionary.get("CDM.General.Browser_Title"));
330 file_chooser.setFileFilter(new ImageFilter());
331 file_chooser.setSize(400,300);
332 GUIUtils.disableRename(file_chooser);
333 int value = file_chooser.showOpenDialog(Gatherer.g_man);
334 // If the user hasn't cancelled, retrieve the file path selected
335 if(value == JFileChooser.APPROVE_OPTION) {
336 // If the file isn't in the images folder, then ask the user if they want to copy it there
337 File file = file_chooser.getSelectedFile();
338 if (!file.getParentFile().equals(images_folder)) {
339 // Copy the file
340 try {
341 File collection_image_file = new File(images_folder, file.getName());
342 Gatherer.f_man.getQueue().copyFile(file, collection_image_file, true);
343
344 // If we're using a remote Greenstone server, upload the image
345 if (Gatherer.isGsdlRemote) {
346 Gatherer.remoteGreenstoneServer.uploadCollectionFile(
347 CollectionManager.getLoadedCollectionName(), collection_image_file);
348 }
349 }
350 catch(Exception exception) {
351 DebugStream.printStackTrace(exception);
352 // Show warning
353 String[] args = new String[] {file.getAbsolutePath(), images_folder.getAbsolutePath()};
354 JOptionPane.showMessageDialog(Gatherer.g_man, Dictionary.get("CDM.General.Image_Copy_Failed", args), Dictionary.get("General.Error"), JOptionPane.ERROR_MESSAGE);
355 // Nothing else we can do.
356 return;
357 }
358 }
359
360 // Create the path starting _httpcollection_/images/<filename>
361 String path = prefix + file.getName();
362 if (Gatherer.GS3){
363 path = file.getName();
364 }
365 if(event.getSource() == browse_about_icon_button) {
366 icon_textfield.setText(path);
367 icon_collection_collectionmeta.setValue(icon_textfield.getText());
368 }
369 else {
370 small_icon_textfield.setText(path);
371 icon_collection_small_collectionmeta.setValue(small_icon_textfield.getText());
372 }
373 path = null;
374 }
375 }
376
377 /** ImageFilter.java is a 1.4 example used by FileChooserDemo2.java. */
378 private class ImageFilter
379 extends javax.swing.filechooser.FileFilter {
380
381 private Pattern pattern = null;
382
383 public ImageFilter() {
384 pattern = Pattern.compile(".*\\.(gif|png|jpe?g)");
385 }
386
387 // Accept all directories and all .col files
388 public boolean accept(File f) {
389 String filename = f.getName().toLowerCase();
390 Matcher matcher = pattern.matcher(filename);
391 return f.isDirectory() || matcher.matches();
392 }
393
394 // The description of this filter
395 public String getDescription() {
396 return Dictionary.get("CDM.General.Image_Filter");
397 }
398 }
399 }
400
401 private class CollectionTitleUpdater
402 implements DocumentListener {
403 /** Gives notification that an attribute or set of attributes changed. */
404 public void changedUpdate(DocumentEvent e) {
405 setTitle();
406 }
407 /** Gives notification that there was an insert into the document. */
408 public void insertUpdate(DocumentEvent e) {
409 setTitle();
410 }
411 /** Gives notification that a portion of the document has been removed. */
412 public void removeUpdate(DocumentEvent e) {
413 setTitle();
414 }
415
416 private void setTitle() {
417 // Set the title
418 String collection_title = name_textfield.getText();
419 String collection_name = CollectionManager.getLoadedCollectionName();
420 Gatherer.g_man.setTitle(collection_title, collection_name);
421 collection_name_collectionmeta.setValue(name_textfield.getText());
422 collection_title = null;
423 collection_name = null;
424 }
425 }
426 }
427}
Note: See TracBrowser for help on using the repository browser.