eu.etaxonomy.taxeditor.store/src/main/java/eu/etaxonomy/taxeditor/ui/selection/EntitySelectionElement.java

   1 /**
   2  *
   3  */
   4 package eu.etaxonomy.taxeditor.ui.selection;
   5
   6 import java.util.EnumSet;
   7 import java.util.Observable;
   8 import java.util.Observer;
   9
  10 import org.eclipse.core.runtime.IStatus;
  11 import org.eclipse.core.runtime.NullProgressMonitor;
  12 import org.eclipse.jface.wizard.WizardDialog;
  13 import org.eclipse.swt.SWT;
  14 import org.eclipse.swt.events.SelectionAdapter;
  15 import org.eclipse.swt.events.SelectionEvent;
  16 import org.eclipse.swt.events.SelectionListener;
  17 import org.eclipse.swt.graphics.Color;
  18 import org.eclipse.swt.widgets.Button;
  19 import org.eclipse.swt.widgets.Composite;
  20 import org.eclipse.swt.widgets.Label;
  21 import org.eclipse.swt.widgets.Shell;
  22 import org.eclipse.swt.widgets.Text;
  23 import org.springframework.security.core.GrantedAuthority;
  24
  25 import eu.etaxonomy.cdm.api.conversation.ConversationHolder;
  26 import eu.etaxonomy.cdm.api.conversation.IConversationEnabled;
  27 import eu.etaxonomy.cdm.api.service.IAgentService;
  28 import eu.etaxonomy.cdm.api.service.ICollectionService;
  29 import eu.etaxonomy.cdm.api.service.INameService;
  30 import eu.etaxonomy.cdm.api.service.IOccurrenceService;
  31 import eu.etaxonomy.cdm.api.service.IReferenceService;
  32 import eu.etaxonomy.cdm.api.service.IService;
  33 import eu.etaxonomy.cdm.api.service.IUserService;
  34 import eu.etaxonomy.cdm.api.service.molecular.IAmplificationService;
  35 import eu.etaxonomy.cdm.api.service.molecular.IPrimerService;
  36 import eu.etaxonomy.cdm.common.CdmUtils;
  37 import eu.etaxonomy.cdm.model.agent.Institution;
  38 import eu.etaxonomy.cdm.model.agent.Person;
  39 import eu.etaxonomy.cdm.model.agent.Team;
  40 import eu.etaxonomy.cdm.model.common.CdmBase;
  41 import eu.etaxonomy.cdm.model.common.Group;
  42 import eu.etaxonomy.cdm.model.common.ICdmBase;
  43 import eu.etaxonomy.cdm.model.common.IIdentifiableEntity;
  44 import eu.etaxonomy.cdm.model.common.User;
  45 import eu.etaxonomy.cdm.model.molecular.Amplification;
  46 import eu.etaxonomy.cdm.model.molecular.Primer;
  47 import eu.etaxonomy.cdm.model.name.NonViralName;
  48 import eu.etaxonomy.cdm.model.occurrence.Collection;
  49 import eu.etaxonomy.cdm.model.occurrence.SpecimenOrObservationBase;
  50 import eu.etaxonomy.cdm.model.reference.Reference;
  51 import eu.etaxonomy.cdm.persistence.hibernate.CdmDataChangeMap;
  52 import eu.etaxonomy.cdm.persistence.hibernate.permission.CRUD;
  53 import eu.etaxonomy.taxeditor.model.AbstractUtility;
  54 import eu.etaxonomy.taxeditor.model.ImageResources;
  55 import eu.etaxonomy.taxeditor.model.MessagingUtils;
  56 import eu.etaxonomy.taxeditor.preference.Resources;
  57 import eu.etaxonomy.taxeditor.store.CdmStore;
  58 import eu.etaxonomy.taxeditor.store.LoginManager;
  59 import eu.etaxonomy.taxeditor.store.StoreUtil;
  60 import eu.etaxonomy.taxeditor.ui.dialog.selection.SelectionDialogFactory;
  61 import eu.etaxonomy.taxeditor.ui.element.AbstractCdmFormElement;
  62 import eu.etaxonomy.taxeditor.ui.element.CdmFormFactory;
  63 import eu.etaxonomy.taxeditor.ui.element.CdmPropertyChangeEvent;
  64 import eu.etaxonomy.taxeditor.ui.element.ICdmFormElement;
  65 import eu.etaxonomy.taxeditor.ui.element.IEnableableFormElement;
  66 import eu.etaxonomy.taxeditor.ui.element.IEntityElement;
  67 import eu.etaxonomy.taxeditor.ui.element.ILabeledElement;
  68 import eu.etaxonomy.taxeditor.ui.element.ISelectableElement;
  69 import eu.etaxonomy.taxeditor.ui.element.LayoutConstants;
  70 import eu.etaxonomy.taxeditor.ui.element.SelectionArbitrator;
  71 import eu.etaxonomy.taxeditor.ui.section.grantedAuthority.GrantedAuthorityLabelTextProvider;
  72
  73 /**
  74  * <p>
  75  * Abstract AbstractSelectionElement class.
  76  * </p>
  77  *
  78  * @author n.hoffmann
  79  * @created Nov 17, 2009
  80  * @version 1.0
  81  * @param <T>
  82  */
  83 public class EntitySelectionElement<T extends ICdmBase> extends
  84                 AbstractCdmFormElement implements  SelectionListener, IEnableableFormElement, ISelectableElement, IEntityElement<T>, ILabeledElement, IConversationEnabled, Observer {
  85
  86         private static final EnumSet<CRUD> UPDATE = EnumSet.of(CRUD.UPDATE);
  87         private static final EnumSet<CRUD> DELETE = EnumSet.of(CRUD.DELETE);
  88         private static final EnumSet<CRUD> CREATE = EnumSet.of(CRUD.CREATE);
  89
  90         /**
  91          * Bitmask for configuring functionality of selection element
  92          */
  93         public static final int NOTHING = 0; // 000
  94         public static final int EDITABLE = 1 << 0; // 001
  95         public static final int DELETABLE = 1 << 1; // 010
  96         public static final int SELECTABLE = 1 << 2; // 100
  97         public static final int ALL = EDITABLE | DELETABLE | SELECTABLE; // 111
  98
  99         protected T entity;
 100
 101         protected Label label;
 102         protected Text text;
 103         protected Button button_selection;
 104
 105         private SelectionArbitrator selectionArbitrator;
 106
 107         protected Button button_edit;
 108
 109         private final String labelString;
 110
 111         private Composite selectableComposite;
 112
 113         private Button button_remove;
 114
 115         private final boolean isEditable;
 116
 117         private final boolean isDeletable;
 118
 119         private final ConversationHolder conversation;
 120         private Class<T> clazz;
 121
 122         /**
 123          * <p>
 124          * Constructor for AbstractSelectionElement.
 125          * </p>
 126          *
 127          * @param formFactory
 128          *            a {@link eu.etaxonomy.taxeditor.ui.element.CdmFormFactory}
 129          *            object.
 130          * @param conversation
 131          *            TODO
 132          * @param parentElement
 133          *            a {@link eu.etaxonomy.taxeditor.ui.element.ICdmFormElement}
 134          *            object.
 135          * @param labelString
 136          *            a {@link java.lang.String} object.
 137          * @param entity
 138          *            a T object.
 139          * @param isEditable
 140          *            a boolean.
 141          * @param isSelectable
 142          *            a boolean.
 143          * @param isDeletable
 144          *            a boolean.
 145          * @param style
 146          *            a int.
 147          * @param <T>
 148          *            a T object.
 149          */
 150         public EntitySelectionElement(CdmFormFactory formFactory,
 151                         ConversationHolder conversation, ICdmFormElement parentElement,
 152                         String labelString, T entity, int mode, int style) {
 153                 super(formFactory, parentElement);
 154
 155                 this.isEditable = (mode & EDITABLE) == EDITABLE;
 156                 this.isDeletable = (mode & DELETABLE) == DELETABLE;
 157                 boolean isSelectable = (mode & SELECTABLE) == SELECTABLE;
 158
 159                 this.labelString = (labelString == null || labelString.equals("")) ? "" : labelString + " : ";
 160
 161                 this.conversation = conversation;
 162
 163                 if (isSelectable && formFactory.getSelectionProvider() != null) {
 164                         selectionArbitrator = formFactory.createSelectionArbitrator(this);
 165                 }
 166
 167                 createControls(getLayoutComposite(), SWT.NULL);
 168
 169                 setEntity(entity);
 170         }
 171
 172         public EntitySelectionElement(CdmFormFactory formFactory,
 173                         ConversationHolder conversation, ICdmFormElement parentElement, Class<T> clazz,
 174                         String labelString, T entity, int mode, int style) {
 175                 this(formFactory, conversation, parentElement, labelString, entity, mode, style);
 176                 this.clazz = clazz;
 177         }
 178
 179         private void createControls(Composite parent, int style) {
 180
 181                 label = formFactory.createLabel(getLayoutComposite(), labelString,
 182                                 SWT.NULL);
 183
 184                 addControl(label);
 185
 186                 selectableComposite = formFactory.createComposite(getLayoutComposite());
 187
 188                 int columns = 2;
 189                 if (isEditable) {
 190                         columns += 1;
 191                 }
 192                 if (isDeletable) {
 193                         columns += 1;
 194                 }
 195
 196                 selectableComposite.setLayout(LayoutConstants.LAYOUT(columns, false));
 197                 selectableComposite.setLayoutData(LayoutConstants.FILL_HORIZONTALLY());
 198
 199                 addControl(selectableComposite);
 200
 201                 text = formFactory.createText(selectableComposite, null, SWT.WRAP);
 202                 text.setEditable(false);
 203                 addControl(text);
 204
 205                 text.setLayoutData(LayoutConstants.FILL_HORIZONTALLY());
 206                 text.setBackground(StoreUtil
 207                                 .getColor(Resources.COLOR_TEXT_DISABLED_BACKGROUND));
 208
 209                 button_selection = formFactory.createButton(selectableComposite, null,
 210                                 SWT.PUSH);
 211                 button_selection.setImage(ImageResources
 212                                 .getImage(ImageResources.BROWSE_ICON));
 213                 button_selection.setToolTipText("Browse existing");
 214
 215                 addControl(button_selection);
 216                 button_selection.addSelectionListener(this);
 217
 218                 if (isEditable) {
 219                         button_edit = formFactory.createButton(selectableComposite, null,
 220                                         SWT.PUSH);
 221                         button_edit.setImage(ImageResources
 222                                         .getImage(ImageResources.EDIT_ICON));
 223                         button_edit.setToolTipText("Edit");
 224                         addControl(button_edit);
 225                         button_edit.addSelectionListener(new EditListener(this));
 226                 }
 227
 228                 if (isDeletable) {
 229                         button_remove = formFactory.createButton(selectableComposite, null,
 230                                         SWT.PUSH);
 231                         button_remove.setImage(ImageResources
 232                                         .getImage(ImageResources.TRASH_ICON));
 233                         button_remove.setToolTipText("Remove");
 234                         addControl(button_remove);
 235                         button_remove.addSelectionListener(new DeleteListener(this));
 236                 }
 237         }
 238
 239         @Override
 240     public void widgetSelected(SelectionEvent e) {
 241                 T selection = SelectionDialogFactory.getSelectionFromDialog(clazz, getShell(), getConversationHolder(), getEntity(), getParentElement());
 242                 setSelectionInternal(selection);
 243         }
 244
 245         /**
 246          * Return the selected object
 247          *
 248          * @return a T object.
 249          */
 250         public T getSelection() {
 251                 return entity;
 252         }
 253
 254         /*
 255          * (non-Javadoc)
 256          *
 257          * @see
 258          * eu.etaxonomy.taxeditor.forms.IEnableableFormElement#setEnabled(boolean)
 259          */
 260         /** {@inheritDoc} */
 261         @Override
 262         public void setEnabled(boolean enabled) {
 263
 264                 button_selection.setEnabled(enabled);
 265                 if (isDeletable){
 266                     button_remove.setEnabled(enabled);
 267                 }
 268                 if (isEditable) {
 269                         updateButtonStates();
 270                 }
 271
 272         }
 273
 274         /* (non-Javadoc)
 275          * @see eu.etaxonomy.taxeditor.ui.element.IEnableableFormElement#isEnabled()
 276          */
 277         @Override
 278         public boolean isEnabled() {
 279             return button_selection.isEnabled();
 280         }
 281
 282         /**
 283          * <p>
 284          * setSelectionInternal
 285          * </p>
 286          *
 287          * @param selection
 288          *            a T object.
 289          */
 290         protected void setSelectionInternal(T selection) {
 291                 if (selection != null && !selection.equals(this.entity)) {
 292                         setEntity(selection);
 293                         firePropertyChangeEvent(new CdmPropertyChangeEvent(this, null));
 294                 }
 295         }
 296
 297         /**
 298          * <p>
 299          * Setter for the field <code>entity</code>.
 300          * </p>
 301          *
 302          * @param selection
 303          *            a T object.
 304          */
 305         public void setEntity(T selection) {
 306                 this.entity = selection;
 307                 updateElement();
 308         }
 309
 310         /**
 311          * Updates this elements view
 312          */
 313         protected void updateElement() {
 314                 String title = CdmUtils.Nz(getTitle());
 315                 text.setText(title); // title can be null
 316                 if (isEditable) {
 317                         updateButtonStates();
 318                 }
 319         }
 320
 321     public void updateFromWizard() {
 322                 updateElement();
 323                 firePropertyChangeEvent(new CdmPropertyChangeEvent(this, null));
 324         }
 325
 326         /**
 327          * <p>
 328          * getTitle
 329          * </p>
 330          *
 331          * @return a {@link java.lang.String} object.
 332          */
 333         protected String getTitle() {
 334                 if (entity != null){
 335                         if(entity instanceof IIdentifiableEntity) {
 336                                 return ((IIdentifiableEntity) entity).getTitleCache();
 337                         } else if(entity instanceof Group){
 338                                 return ((Group) entity).getName();
 339                         } else if(entity instanceof GrantedAuthority){
 340                                 return GrantedAuthorityLabelTextProvider.getText(((GrantedAuthority) entity));
 341                         } else if(entity instanceof User){
 342                 return ((User) entity).getUsername();
 343             } else if (entity instanceof Primer){
 344                 return ((Primer) entity).getLabel();
 345             } else if (entity instanceof Amplification){
 346                 return ((Amplification) entity).getLabelCache();
 347             }
 348
 349                 }
 350                 return "";
 351         }
 352
 353         /** {@inheritDoc} */
 354         @Override
 355         public void setSelected(boolean selected) {
 356                 setBackground(selected ? SELECTED : getPersistentBackground());
 357         }
 358
 359         /*
 360          * (non-Javadoc)
 361          *
 362          * @see eu.etaxonomy.taxeditor.forms.IEntityElement#getEntity()
 363          */
 364         /**
 365          * <p>
 366          * Getter for the field <code>entity</code>.
 367          * </p>
 368          *
 369          * @return a T object.
 370          */
 371         @Override
 372         public T getEntity() {
 373                 return entity;
 374         }
 375
 376         /*
 377          * (non-Javadoc)
 378          *
 379          * @see eu.etaxonomy.taxeditor.forms.section.cdmdetail.ISelectableElement#
 380          * getSelectionArbitrator()
 381          */
 382         /**
 383          * <p>
 384          * Getter for the field <code>selectionArbitrator</code>.
 385          * </p>
 386          *
 387          * @return a {@link eu.etaxonomy.taxeditor.ui.element.SelectionArbitrator}
 388          *         object.
 389          */
 390         @Override
 391         public SelectionArbitrator getSelectionArbitrator() {
 392                 return selectionArbitrator;
 393         }
 394
 395         /**
 396          * Convenient access to current shell
 397          *
 398          * @return a {@link org.eclipse.swt.widgets.Shell} object.
 399          */
 400     public Shell getShell() {
 401                 return getLayoutComposite().getShell();
 402         }
 403
 404         /** {@inheritDoc} */
 405         @Override
 406         public void setIrrelevant(boolean irrelevant) {
 407                 String colorId = irrelevant ? Resources.COLOR_COMPOSITE_IRRELEVANT
 408                                 : Resources.COLOR_TEXT_DISABLED_BACKGROUND;
 409
 410                 Color color = StoreUtil.getColor(colorId);
 411                 text.setBackground(color);
 412         }
 413
 414         private class DeleteListener extends SelectionAdapter {
 415
 416                 private final EntitySelectionElement<T> selectionElement;
 417
 418                 public DeleteListener(EntitySelectionElement<T> selectionElement) {
 419                         this.selectionElement = selectionElement;
 420                 }
 421
 422                 @Override
 423                 public void widgetSelected(SelectionEvent e) {
 424                         setEntity(null);
 425                         firePropertyChangeEvent(new CdmPropertyChangeEvent(
 426                                         selectionElement, null));
 427                 }
 428         }
 429
 430         private class EditListener extends SelectionAdapter {
 431
 432         private static final String TRANSIENT_EDITING_WARNING_TEXT = "Warning: All changes for this element are directly reflected in the data base.\nThe \"Cancel\" button has no effect";
 433         private static final String TRANSIENT_EDITING_WARNING_TITLE = "CDM element not yet saved.";
 434         private final EntitySelectionElement<T> selectionElement;
 435
 436                 public EditListener(EntitySelectionElement<T> selectionElement) {
 437                         this.selectionElement = selectionElement;
 438                 }
 439
 440                 /** {@inheritDoc} */
 441                 @Override
 442                 public void widgetSelected(SelectionEvent e) {
 443                     T originalEntity = selectionElement.getEntity();
 444                     T clonedEntity = null;
 445                     IService<T> service = null;
 446                     if(originalEntity instanceof CdmBase){
 447                         //get corresponding service
 448                         if(entity instanceof Reference<?>){
 449                             service = (IService<T>) CdmStore.getService(IReferenceService.class);
 450                         }
 451                         else if (entity instanceof Team || entity instanceof Person || entity instanceof Institution) {
 452                             service = (IService<T>) CdmStore.getService(IAgentService.class);
 453                         }
 454                         else if (entity instanceof NonViralName) {
 455                             service = (IService<T>) CdmStore.getService(INameService.class);
 456                         }
 457                         else if (entity instanceof SpecimenOrObservationBase) {
 458                             service = (IService<T>) CdmStore.getService(IOccurrenceService.class);
 459                         }
 460                         else if (entity instanceof Collection) {
 461                             service = (IService<T>) CdmStore.getService(ICollectionService.class);
 462                         }
 463                         else if (entity instanceof User) {
 464                             service = (IService<T>) CdmStore.getService(IUserService.class);
 465                         }
 466                         else if (entity instanceof Primer) {
 467                             service = (IService<T>) CdmStore.getService(IPrimerService.class);
 468                         }
 469                         else if (entity instanceof Amplification) {
 470                             service = (IService<T>) CdmStore.getService(IAmplificationService.class);
 471                         }
 472                         //check if original already exists in data base. If not then do not clone and all changes will be persisted directly -> Warning to user.
 473                 if(service !=null && service.find(originalEntity.getUuid())==null && originalEntity.getId() != 0){
 474                     if(MessagingUtils.confirmDialog(TRANSIENT_EDITING_WARNING_TITLE, "["+originalEntity.getClass().getSimpleName()+"]"+originalEntity + " has to be saved before it can be edited. Save now?")){
 475                         service.save(originalEntity);
 476                         AbstractUtility.getActiveEditor().doSave(new NullProgressMonitor());
 477                     }
 478                     else{
 479                         //transient CDM elements should not be edited to avoid merge conflicts
 480                         // when the elements are cascaded
 481                         return;
 482                     }
 483                 }
 484                 else{
 485                     //FIXME temporarily disabled cloning re-opening bug #2645 (EditFromSelectionWizard persists data even when canceled)
 486 //                    try {
 487 //                        //clone original
 488 //                        clonedEntity = (T) ((CdmBase) originalEntity).clone();
 489 //                    } catch (CloneNotSupportedException e1) {
 490 //                        MessagingUtils.warningDialog(TRANSIENT_EDITING_WARNING_TITLE, this, TRANSIENT_EDITING_WARNING_TEXT);
 491 //                    }
 492                 }
 493
 494                     }
 495                     if(clonedEntity!=null){
 496                         selectionElement.setEntity(clonedEntity);
 497                     }
 498                         WizardDialog dialog = new WizardDialog(selectionElement.getShell(),
 499                                         new EditFromSelectionWizard(selectionElement));
 500                         if (dialog.open() == IStatus.OK) {
 501                             if(service!=null && clonedEntity!=null){//check if cloning happened
 502                                 T editedClonedEntity = selectionElement.getEntity();
 503                                 editedClonedEntity.setId(originalEntity.getId());
 504                                 editedClonedEntity.setUuid(originalEntity.getUuid());
 505
 506                                 //merge clone and original
 507                                 service.merge(editedClonedEntity);
 508                                 originalEntity = service.load(originalEntity.getUuid());
 509
 510                             }
 511                             selectionElement.setEntity(originalEntity);
 512                                 selectionElement.updateFromWizard();
 513                         }
 514                         //be sure to reset to original in all cases
 515                         selectionElement.setEntity(originalEntity);
 516                         selectionElement.refresh();
 517                 }
 518         }
 519
 520         // not used
 521         /** {@inheritDoc} */
 522         @Override
 523         public void widgetDefaultSelected(SelectionEvent e) {
 524         }
 525
 526         /**
 527          * <p>
 528          * getConversationHolder
 529          * </p>
 530          *
 531          * @return a {@link eu.etaxonomy.cdm.api.conversation.ConversationHolder}
 532          *         object.
 533          */
 534         @Override
 535         public ConversationHolder getConversationHolder() {
 536                 return conversation;
 537         }
 538
 539         /** {@inheritDoc} */
 540         @Override
 541         public void setBackground(Color color) {
 542             if(!label.isDisposed()){
 543                 label.setBackground(color);
 544             }
 545         }
 546
 547         /** {@inheritDoc} */
 548         @Override
 549         public void setLabel(String labelString) {
 550                 if (label != null) {
 551                         label.setText(labelString);
 552                 }
 553         }
 554
 555         /**
 556          * <p>
 557          * Getter for the field <code>label</code>.
 558          * </p>
 559          *
 560          * @return a {@link java.lang.String} object.
 561          */
 562         @Override
 563         public String getLabel() {
 564                 if (label != null) {
 565                         return label.getText() + " : ";
 566                 }
 567                 return null;
 568         }
 569
 570         /** {@inheritDoc} */
 571         @Override
 572         public void update(CdmDataChangeMap changeEvents) {
 573         }
 574
 575         /* (non-Javadoc)
 576          * @see eu.etaxonomy.taxeditor.ui.element.AbstractCdmFormElement#removeElements()
 577          */
 578         @Override
 579     public void removeElements(){
 580                 super.removeElements();
 581                 LoginManager loginManager = CdmStore.getLoginManager();
 582                 loginManager.addObserver(this);
 583         }
 584
 585         @Override
 586         public void update(Observable o, Object arg) {
 587                 if(o instanceof LoginManager){
 588                         updateButtonStates();
 589                 }
 590         }
 591
 592         private void updateButtonStates() {
 593             if(button_edit != null && !button_selection.isDisposed()){
 594                 button_edit.setEnabled(isEditable && button_selection.isEnabled() && getEntity() != null  && CdmStore.currentAuthentiationHasPermission((CdmBase) getEntity(), UPDATE));
 595             }
 596         }
 597 }