| /* |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| */ |
| |
| package org.netbeans.modules.j2ee.sun.validation.constraints; |
| |
| import java.util.ArrayList; |
| import java.util.Collection; |
| |
| import org.netbeans.modules.j2ee.sun.validation.constraints.ConstraintFailure; |
| import org.netbeans.modules.j2ee.sun.validation.util.BundleReader; |
| |
| /** |
| * MandatoryConstraint is a {@link Constraint} to validate non-null objects. |
| * It implements <code>Constraint</code> interface and extends |
| * {@link ConstraintUtils} class. |
| * <code>match</code> method of this object returns empty |
| * <code>Collection</code> if the value/object being validated is non |
| * <code>null</code>; else it returns a <code>Collection</code> with a |
| * {@link ConstraintFailure} object in it. <code>ConstraintUtils</code> class |
| * provides utility methods for formating failure messages and a |
| * <code>print<method> method to print this object. |
| * |
| * @author Rajeshwar Patil |
| * @version %I%, %G% |
| */ |
| public class MandatoryConstraint extends ConstraintUtils |
| implements Constraint{ |
| |
| /** Creates a new instance of <code>MandatoryConstraint</code>. */ |
| public MandatoryConstraint() { |
| } |
| |
| |
| /** |
| * Validates the given value against this <code>Constraint</code>. |
| * |
| * @param value the value to be validated. |
| * @param name the element name, value of which is being validated. |
| * It is used only in case of <code>Constraint</code> failure, to construct |
| * the failure message. |
| * |
| * @return <code>Collection</code> the Collection of |
| * <code>ConstraintFailure</code> Objects. Collection is empty if |
| * there are no failures. |
| */ |
| public Collection match(String value, String name) { |
| return match((Object)value, name); |
| } |
| |
| |
| /** |
| * Validates the given value against this <code>Constraint</code>. |
| * |
| * @param value the value to be validated. |
| * @param name the element name, value of which is being validated. |
| * It is used only in case of <code>Constraint</code> failure to construct |
| * the faiulure message. |
| * |
| * @return <code>Collection</code> the Collection of |
| * <code>ConstraintFailure</code> Objects. Collection is empty if |
| * there are no failures. This method will fail, if the given vlaue is null. |
| */ |
| public java.util.Collection match(Object value, String name) { |
| Collection failed_constrained_list = new ArrayList(); |
| if (null == value){ |
| String failureMessage = formatFailureMessage(toString(), name); |
| failed_constrained_list.add(new ConstraintFailure(toString(), value, |
| name, failureMessage, BundleReader.getValue( |
| "MSG_MandatoryConstraint_Failure"))); //NOI18N |
| } |
| return failed_constrained_list; |
| } |
| } |