svn commit: r1063448 - /commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java

[si...@apache.org]

Author: simonetripodi
Date: Tue Jan 25 20:40:24 2011
New Revision: 1063448

URL: http://svn.apache.org/viewvc?rev=1063448&view=rev
Log:
first checkin of Digester rule binder

Added:
    commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java   (with props)

Added: commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java
URL: http://svn.apache.org/viewvc/commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java?rev=1063448&view=auto
==============================================================================
--- commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java (added)
+++ commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java Tue Jan 25 20:40:24 2011
@@ -0,0 +1,47 @@
+/* $Id$
+ *
+ * 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.apache.commons.digester3;
+
+/**
+ * The Digester EDSL.
+ */
+public interface RulesBinder {
+
+    /**
+     * Records an error message which will be presented to the user at a later
+     * time. Unlike throwing an exception, this enable us to continue
+     * configuring the Digester and discover more errors. Uses {@link
+     * String#format(String, Object[])} to insert the arguments into the
+     * message.
+     *
+     * @param messagePattern The message string pattern
+     * @param arguments Arguments referenced by the format specifiers in the format string
+     */
+    void addError(String messagePattern, Object... arguments);
+
+    /**
+     * Records an exception, the full details of which will be logged, and the
+     * message of which will be presented to the user at a later
+     * time. If your Module calls something that you worry may fail, you should
+     * catch the exception and pass it into this.
+     *
+     * @param t The exception has to be recorded.
+     */
+    void addError(Throwable t);
+
+}

Propchange: commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Propchange: commons/sandbox/digester3/trunk/src/main/java/org/apache/commons/digester3/RulesBinder.java
------------------------------------------------------------------------------
    svn:mime-type = text/plain