001/*
002 * CDDL HEADER START
003 *
004 * The contents of this file are subject to the terms of the
005 * Common Development and Distribution License, Version 1.0 only
006 * (the "License").  You may not use this file except in compliance
007 * with the License.
008 *
009 * You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
010 * or http://forgerock.org/license/CDDLv1.0.html.
011 * See the License for the specific language governing permissions
012 * and limitations under the License.
013 *
014 * When distributing Covered Code, include this CDDL HEADER in each
015 * file and include the License file at legal-notices/CDDLv1_0.txt.
016 * If applicable, add the following below this CDDL HEADER, with the
017 * fields enclosed by brackets "[]" replaced with your own identifying
018 * information:
019 *      Portions Copyright [yyyy] [name of copyright owner]
020 *
021 * CDDL HEADER END
022 *
023 *
024 *      Copyright 2008 Sun Microsystems, Inc.
025 */
026package org.opends.server.admin.std.meta;
027
028
029
030import java.util.Collection;
031import java.util.SortedSet;
032import org.opends.server.admin.AdministratorAction;
033import org.opends.server.admin.BooleanPropertyDefinition;
034import org.opends.server.admin.ClassPropertyDefinition;
035import org.opends.server.admin.client.AuthorizationException;
036import org.opends.server.admin.client.CommunicationException;
037import org.opends.server.admin.client.ConcurrentModificationException;
038import org.opends.server.admin.client.ManagedObject;
039import org.opends.server.admin.client.MissingMandatoryPropertiesException;
040import org.opends.server.admin.client.OperationRejectedException;
041import org.opends.server.admin.DefaultBehaviorProvider;
042import org.opends.server.admin.DefinedDefaultBehaviorProvider;
043import org.opends.server.admin.ManagedObjectAlreadyExistsException;
044import org.opends.server.admin.ManagedObjectDefinition;
045import org.opends.server.admin.PropertyOption;
046import org.opends.server.admin.PropertyProvider;
047import org.opends.server.admin.server.ConfigurationChangeListener;
048import org.opends.server.admin.server.ServerManagedObject;
049import org.opends.server.admin.std.client.SMTPAlertHandlerCfgClient;
050import org.opends.server.admin.std.server.AlertHandlerCfg;
051import org.opends.server.admin.std.server.SMTPAlertHandlerCfg;
052import org.opends.server.admin.StringPropertyDefinition;
053import org.opends.server.admin.Tag;
054import org.opends.server.admin.UndefinedDefaultBehaviorProvider;
055import org.opends.server.types.DN;
056
057
058
059/**
060 * An interface for querying the SMTP Alert Handler managed object
061 * definition meta information.
062 * <p>
063 * The SMTP Alert Handler may be used to send e-mail messages to
064 * notify administrators of significant events that occur within the
065 * server.
066 */
067public final class SMTPAlertHandlerCfgDefn extends ManagedObjectDefinition<SMTPAlertHandlerCfgClient, SMTPAlertHandlerCfg> {
068
069  // The singleton configuration definition instance.
070  private static final SMTPAlertHandlerCfgDefn INSTANCE = new SMTPAlertHandlerCfgDefn();
071
072
073
074  // The "java-class" property definition.
075  private static final ClassPropertyDefinition PD_JAVA_CLASS;
076
077
078
079  // The "message-body" property definition.
080  private static final StringPropertyDefinition PD_MESSAGE_BODY;
081
082
083
084  // The "message-subject" property definition.
085  private static final StringPropertyDefinition PD_MESSAGE_SUBJECT;
086
087
088
089  // The "recipient-address" property definition.
090  private static final StringPropertyDefinition PD_RECIPIENT_ADDRESS;
091
092
093
094  // The "sender-address" property definition.
095  private static final StringPropertyDefinition PD_SENDER_ADDRESS;
096
097
098
099  // Build the "java-class" property definition.
100  static {
101      ClassPropertyDefinition.Builder builder = ClassPropertyDefinition.createBuilder(INSTANCE, "java-class");
102      builder.setOption(PropertyOption.MANDATORY);
103      builder.setOption(PropertyOption.ADVANCED);
104      builder.setAdministratorAction(new AdministratorAction(AdministratorAction.Type.COMPONENT_RESTART, INSTANCE, "java-class"));
105      DefaultBehaviorProvider<String> provider = new DefinedDefaultBehaviorProvider<String>("org.opends.server.extensions.SMTPAlertHandler");
106      builder.setDefaultBehaviorProvider(provider);
107      builder.addInstanceOf("org.opends.server.api.AlertHandler");
108      PD_JAVA_CLASS = builder.getInstance();
109      INSTANCE.registerPropertyDefinition(PD_JAVA_CLASS);
110  }
111
112
113
114  // Build the "message-body" property definition.
115  static {
116      StringPropertyDefinition.Builder builder = StringPropertyDefinition.createBuilder(INSTANCE, "message-body");
117      builder.setOption(PropertyOption.MANDATORY);
118      builder.setAdministratorAction(new AdministratorAction(AdministratorAction.Type.NONE, INSTANCE, "message-body"));
119      builder.setDefaultBehaviorProvider(new UndefinedDefaultBehaviorProvider<String>());
120      PD_MESSAGE_BODY = builder.getInstance();
121      INSTANCE.registerPropertyDefinition(PD_MESSAGE_BODY);
122  }
123
124
125
126  // Build the "message-subject" property definition.
127  static {
128      StringPropertyDefinition.Builder builder = StringPropertyDefinition.createBuilder(INSTANCE, "message-subject");
129      builder.setOption(PropertyOption.MANDATORY);
130      builder.setAdministratorAction(new AdministratorAction(AdministratorAction.Type.NONE, INSTANCE, "message-subject"));
131      builder.setDefaultBehaviorProvider(new UndefinedDefaultBehaviorProvider<String>());
132      PD_MESSAGE_SUBJECT = builder.getInstance();
133      INSTANCE.registerPropertyDefinition(PD_MESSAGE_SUBJECT);
134  }
135
136
137
138  // Build the "recipient-address" property definition.
139  static {
140      StringPropertyDefinition.Builder builder = StringPropertyDefinition.createBuilder(INSTANCE, "recipient-address");
141      builder.setOption(PropertyOption.MULTI_VALUED);
142      builder.setOption(PropertyOption.MANDATORY);
143      builder.setAdministratorAction(new AdministratorAction(AdministratorAction.Type.NONE, INSTANCE, "recipient-address"));
144      builder.setDefaultBehaviorProvider(new UndefinedDefaultBehaviorProvider<String>());
145      PD_RECIPIENT_ADDRESS = builder.getInstance();
146      INSTANCE.registerPropertyDefinition(PD_RECIPIENT_ADDRESS);
147  }
148
149
150
151  // Build the "sender-address" property definition.
152  static {
153      StringPropertyDefinition.Builder builder = StringPropertyDefinition.createBuilder(INSTANCE, "sender-address");
154      builder.setOption(PropertyOption.MANDATORY);
155      builder.setAdministratorAction(new AdministratorAction(AdministratorAction.Type.NONE, INSTANCE, "sender-address"));
156      builder.setDefaultBehaviorProvider(new UndefinedDefaultBehaviorProvider<String>());
157      PD_SENDER_ADDRESS = builder.getInstance();
158      INSTANCE.registerPropertyDefinition(PD_SENDER_ADDRESS);
159  }
160
161
162
163  // Register the tags associated with this managed object definition.
164  static {
165    INSTANCE.registerTag(Tag.valueOf("core-server"));
166  }
167
168
169
170  /**
171   * Get the SMTP Alert Handler configuration definition singleton.
172   *
173   * @return Returns the SMTP Alert Handler configuration definition
174   *         singleton.
175   */
176  public static SMTPAlertHandlerCfgDefn getInstance() {
177    return INSTANCE;
178  }
179
180
181
182  /**
183   * Private constructor.
184   */
185  private SMTPAlertHandlerCfgDefn() {
186    super("smtp-alert-handler", AlertHandlerCfgDefn.getInstance());
187  }
188
189
190
191  /**
192   * {@inheritDoc}
193   */
194  public SMTPAlertHandlerCfgClient createClientConfiguration(
195      ManagedObject<? extends SMTPAlertHandlerCfgClient> impl) {
196    return new SMTPAlertHandlerCfgClientImpl(impl);
197  }
198
199
200
201  /**
202   * {@inheritDoc}
203   */
204  public SMTPAlertHandlerCfg createServerConfiguration(
205      ServerManagedObject<? extends SMTPAlertHandlerCfg> impl) {
206    return new SMTPAlertHandlerCfgServerImpl(impl);
207  }
208
209
210
211  /**
212   * {@inheritDoc}
213   */
214  public Class<SMTPAlertHandlerCfg> getServerConfigurationClass() {
215    return SMTPAlertHandlerCfg.class;
216  }
217
218
219
220  /**
221   * Get the "disabled-alert-type" property definition.
222   * <p>
223   * Specifies the names of the alert types that are disabled for this
224   * alert handler.
225   * <p>
226   * If there are any values for this attribute, then no alerts with
227   * any of the specified types are allowed. If there are no values for
228   * this attribute, then only alerts with a type included in the set
229   * of enabled alert types are allowed, or if there are no values for
230   * the enabled alert types option, then all alert types are allowed.
231   *
232   * @return Returns the "disabled-alert-type" property definition.
233   */
234  public StringPropertyDefinition getDisabledAlertTypePropertyDefinition() {
235    return AlertHandlerCfgDefn.getInstance().getDisabledAlertTypePropertyDefinition();
236  }
237
238
239
240  /**
241   * Get the "enabled" property definition.
242   * <p>
243   * Indicates whether the SMTP Alert Handler is enabled.
244   *
245   * @return Returns the "enabled" property definition.
246   */
247  public BooleanPropertyDefinition getEnabledPropertyDefinition() {
248    return AlertHandlerCfgDefn.getInstance().getEnabledPropertyDefinition();
249  }
250
251
252
253  /**
254   * Get the "enabled-alert-type" property definition.
255   * <p>
256   * Specifies the names of the alert types that are enabled for this
257   * alert handler.
258   * <p>
259   * If there are any values for this attribute, then only alerts with
260   * one of the specified types are allowed (unless they are also
261   * included in the disabled alert types). If there are no values for
262   * this attribute, then any alert with a type not included in the
263   * list of disabled alert types is allowed.
264   *
265   * @return Returns the "enabled-alert-type" property definition.
266   */
267  public StringPropertyDefinition getEnabledAlertTypePropertyDefinition() {
268    return AlertHandlerCfgDefn.getInstance().getEnabledAlertTypePropertyDefinition();
269  }
270
271
272
273  /**
274   * Get the "java-class" property definition.
275   * <p>
276   * Specifies the fully-qualified name of the Java class that
277   * provides the SMTP Alert Handler implementation.
278   *
279   * @return Returns the "java-class" property definition.
280   */
281  public ClassPropertyDefinition getJavaClassPropertyDefinition() {
282    return PD_JAVA_CLASS;
283  }
284
285
286
287  /**
288   * Get the "message-body" property definition.
289   * <p>
290   * Specifies the body that should be used for email messages
291   * generated by this alert handler.
292   * <p>
293   * The token "%%%%alert-type%%%%" is dynamically replaced with the
294   * alert type string. The token "%%%%alert-id%%%%" is dynamically
295   * replaced with the alert ID value. The token
296   * "%%%%alert-message%%%%" is dynamically replaced with the alert
297   * message. The token "\\n" is replaced with an end-of-line marker.
298   *
299   * @return Returns the "message-body" property definition.
300   */
301  public StringPropertyDefinition getMessageBodyPropertyDefinition() {
302    return PD_MESSAGE_BODY;
303  }
304
305
306
307  /**
308   * Get the "message-subject" property definition.
309   * <p>
310   * Specifies the subject that should be used for email messages
311   * generated by this alert handler.
312   * <p>
313   * The token "%%%%alert-type%%%%" is dynamically replaced with the
314   * alert type string. The token "%%%%alert-id%%%%" is dynamically
315   * replaced with the alert ID value. The token
316   * "%%%%alert-message%%%%" is dynamically replaced with the alert
317   * message. The token "\\n" is replaced with an end-of-line marker.
318   *
319   * @return Returns the "message-subject" property definition.
320   */
321  public StringPropertyDefinition getMessageSubjectPropertyDefinition() {
322    return PD_MESSAGE_SUBJECT;
323  }
324
325
326
327  /**
328   * Get the "recipient-address" property definition.
329   * <p>
330   * Specifies an email address to which the messages should be sent.
331   * <p>
332   * Multiple values may be provided if there should be more than one
333   * recipient.
334   *
335   * @return Returns the "recipient-address" property definition.
336   */
337  public StringPropertyDefinition getRecipientAddressPropertyDefinition() {
338    return PD_RECIPIENT_ADDRESS;
339  }
340
341
342
343  /**
344   * Get the "sender-address" property definition.
345   * <p>
346   * Specifies the email address to use as the sender for messages
347   * generated by this alert handler.
348   *
349   * @return Returns the "sender-address" property definition.
350   */
351  public StringPropertyDefinition getSenderAddressPropertyDefinition() {
352    return PD_SENDER_ADDRESS;
353  }
354
355
356
357  /**
358   * Managed object client implementation.
359   */
360  private static class SMTPAlertHandlerCfgClientImpl implements
361    SMTPAlertHandlerCfgClient {
362
363    // Private implementation.
364    private ManagedObject<? extends SMTPAlertHandlerCfgClient> impl;
365
366
367
368    // Private constructor.
369    private SMTPAlertHandlerCfgClientImpl(
370        ManagedObject<? extends SMTPAlertHandlerCfgClient> impl) {
371      this.impl = impl;
372    }
373
374
375
376    /**
377     * {@inheritDoc}
378     */
379    public SortedSet<String> getDisabledAlertType() {
380      return impl.getPropertyValues(INSTANCE.getDisabledAlertTypePropertyDefinition());
381    }
382
383
384
385    /**
386     * {@inheritDoc}
387     */
388    public void setDisabledAlertType(Collection<String> values) {
389      impl.setPropertyValues(INSTANCE.getDisabledAlertTypePropertyDefinition(), values);
390    }
391
392
393
394    /**
395     * {@inheritDoc}
396     */
397    public Boolean isEnabled() {
398      return impl.getPropertyValue(INSTANCE.getEnabledPropertyDefinition());
399    }
400
401
402
403    /**
404     * {@inheritDoc}
405     */
406    public void setEnabled(boolean value) {
407      impl.setPropertyValue(INSTANCE.getEnabledPropertyDefinition(), value);
408    }
409
410
411
412    /**
413     * {@inheritDoc}
414     */
415    public SortedSet<String> getEnabledAlertType() {
416      return impl.getPropertyValues(INSTANCE.getEnabledAlertTypePropertyDefinition());
417    }
418
419
420
421    /**
422     * {@inheritDoc}
423     */
424    public void setEnabledAlertType(Collection<String> values) {
425      impl.setPropertyValues(INSTANCE.getEnabledAlertTypePropertyDefinition(), values);
426    }
427
428
429
430    /**
431     * {@inheritDoc}
432     */
433    public String getJavaClass() {
434      return impl.getPropertyValue(INSTANCE.getJavaClassPropertyDefinition());
435    }
436
437
438
439    /**
440     * {@inheritDoc}
441     */
442    public void setJavaClass(String value) {
443      impl.setPropertyValue(INSTANCE.getJavaClassPropertyDefinition(), value);
444    }
445
446
447
448    /**
449     * {@inheritDoc}
450     */
451    public String getMessageBody() {
452      return impl.getPropertyValue(INSTANCE.getMessageBodyPropertyDefinition());
453    }
454
455
456
457    /**
458     * {@inheritDoc}
459     */
460    public void setMessageBody(String value) {
461      impl.setPropertyValue(INSTANCE.getMessageBodyPropertyDefinition(), value);
462    }
463
464
465
466    /**
467     * {@inheritDoc}
468     */
469    public String getMessageSubject() {
470      return impl.getPropertyValue(INSTANCE.getMessageSubjectPropertyDefinition());
471    }
472
473
474
475    /**
476     * {@inheritDoc}
477     */
478    public void setMessageSubject(String value) {
479      impl.setPropertyValue(INSTANCE.getMessageSubjectPropertyDefinition(), value);
480    }
481
482
483
484    /**
485     * {@inheritDoc}
486     */
487    public SortedSet<String> getRecipientAddress() {
488      return impl.getPropertyValues(INSTANCE.getRecipientAddressPropertyDefinition());
489    }
490
491
492
493    /**
494     * {@inheritDoc}
495     */
496    public void setRecipientAddress(Collection<String> values) {
497      impl.setPropertyValues(INSTANCE.getRecipientAddressPropertyDefinition(), values);
498    }
499
500
501
502    /**
503     * {@inheritDoc}
504     */
505    public String getSenderAddress() {
506      return impl.getPropertyValue(INSTANCE.getSenderAddressPropertyDefinition());
507    }
508
509
510
511    /**
512     * {@inheritDoc}
513     */
514    public void setSenderAddress(String value) {
515      impl.setPropertyValue(INSTANCE.getSenderAddressPropertyDefinition(), value);
516    }
517
518
519
520    /**
521     * {@inheritDoc}
522     */
523    public ManagedObjectDefinition<? extends SMTPAlertHandlerCfgClient, ? extends SMTPAlertHandlerCfg> definition() {
524      return INSTANCE;
525    }
526
527
528
529    /**
530     * {@inheritDoc}
531     */
532    public PropertyProvider properties() {
533      return impl;
534    }
535
536
537
538    /**
539     * {@inheritDoc}
540     */
541    public void commit() throws ManagedObjectAlreadyExistsException,
542        MissingMandatoryPropertiesException, ConcurrentModificationException,
543        OperationRejectedException, AuthorizationException,
544        CommunicationException {
545      impl.commit();
546    }
547
548
549
550    /** {@inheritDoc} */
551    public String toString() {
552      return impl.toString();
553    }
554  }
555
556
557
558  /**
559   * Managed object server implementation.
560   */
561  private static class SMTPAlertHandlerCfgServerImpl implements
562    SMTPAlertHandlerCfg {
563
564    // Private implementation.
565    private ServerManagedObject<? extends SMTPAlertHandlerCfg> impl;
566
567    // The value of the "disabled-alert-type" property.
568    private final SortedSet<String> pDisabledAlertType;
569
570    // The value of the "enabled" property.
571    private final boolean pEnabled;
572
573    // The value of the "enabled-alert-type" property.
574    private final SortedSet<String> pEnabledAlertType;
575
576    // The value of the "java-class" property.
577    private final String pJavaClass;
578
579    // The value of the "message-body" property.
580    private final String pMessageBody;
581
582    // The value of the "message-subject" property.
583    private final String pMessageSubject;
584
585    // The value of the "recipient-address" property.
586    private final SortedSet<String> pRecipientAddress;
587
588    // The value of the "sender-address" property.
589    private final String pSenderAddress;
590
591
592
593    // Private constructor.
594    private SMTPAlertHandlerCfgServerImpl(ServerManagedObject<? extends SMTPAlertHandlerCfg> impl) {
595      this.impl = impl;
596      this.pDisabledAlertType = impl.getPropertyValues(INSTANCE.getDisabledAlertTypePropertyDefinition());
597      this.pEnabled = impl.getPropertyValue(INSTANCE.getEnabledPropertyDefinition());
598      this.pEnabledAlertType = impl.getPropertyValues(INSTANCE.getEnabledAlertTypePropertyDefinition());
599      this.pJavaClass = impl.getPropertyValue(INSTANCE.getJavaClassPropertyDefinition());
600      this.pMessageBody = impl.getPropertyValue(INSTANCE.getMessageBodyPropertyDefinition());
601      this.pMessageSubject = impl.getPropertyValue(INSTANCE.getMessageSubjectPropertyDefinition());
602      this.pRecipientAddress = impl.getPropertyValues(INSTANCE.getRecipientAddressPropertyDefinition());
603      this.pSenderAddress = impl.getPropertyValue(INSTANCE.getSenderAddressPropertyDefinition());
604    }
605
606
607
608    /**
609     * {@inheritDoc}
610     */
611    public void addSMTPChangeListener(
612        ConfigurationChangeListener<SMTPAlertHandlerCfg> listener) {
613      impl.registerChangeListener(listener);
614    }
615
616
617
618    /**
619     * {@inheritDoc}
620     */
621    public void removeSMTPChangeListener(
622        ConfigurationChangeListener<SMTPAlertHandlerCfg> listener) {
623      impl.deregisterChangeListener(listener);
624    }
625    /**
626     * {@inheritDoc}
627     */
628    public void addChangeListener(
629        ConfigurationChangeListener<AlertHandlerCfg> listener) {
630      impl.registerChangeListener(listener);
631    }
632
633
634
635    /**
636     * {@inheritDoc}
637     */
638    public void removeChangeListener(
639        ConfigurationChangeListener<AlertHandlerCfg> listener) {
640      impl.deregisterChangeListener(listener);
641    }
642
643
644
645    /**
646     * {@inheritDoc}
647     */
648    public SortedSet<String> getDisabledAlertType() {
649      return pDisabledAlertType;
650    }
651
652
653
654    /**
655     * {@inheritDoc}
656     */
657    public boolean isEnabled() {
658      return pEnabled;
659    }
660
661
662
663    /**
664     * {@inheritDoc}
665     */
666    public SortedSet<String> getEnabledAlertType() {
667      return pEnabledAlertType;
668    }
669
670
671
672    /**
673     * {@inheritDoc}
674     */
675    public String getJavaClass() {
676      return pJavaClass;
677    }
678
679
680
681    /**
682     * {@inheritDoc}
683     */
684    public String getMessageBody() {
685      return pMessageBody;
686    }
687
688
689
690    /**
691     * {@inheritDoc}
692     */
693    public String getMessageSubject() {
694      return pMessageSubject;
695    }
696
697
698
699    /**
700     * {@inheritDoc}
701     */
702    public SortedSet<String> getRecipientAddress() {
703      return pRecipientAddress;
704    }
705
706
707
708    /**
709     * {@inheritDoc}
710     */
711    public String getSenderAddress() {
712      return pSenderAddress;
713    }
714
715
716
717    /**
718     * {@inheritDoc}
719     */
720    public Class<? extends SMTPAlertHandlerCfg> configurationClass() {
721      return SMTPAlertHandlerCfg.class;
722    }
723
724
725
726    /**
727     * {@inheritDoc}
728     */
729    public DN dn() {
730      return impl.getDN();
731    }
732
733
734
735    /** {@inheritDoc} */
736    public String toString() {
737      return impl.toString();
738    }
739  }
740}