| career | drupal | java | mac | mysql | perl | scala | uml | unix  

Tomcat example source code file (

This example Tomcat source code file ( is included in the "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - Tomcat tags/keywords

attributes, exception, object, object, objectparamrule, objectparamrule, rule, sax, string, string, stringbuffer, stringbuffer

The Tomcat source code

/* $Id: 467222 2006-10-24 03:17:11Z markt $
 * 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
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * See the License for the specific language governing permissions and
 * limitations under the License.

package org.apache.tomcat.util.digester;

import org.xml.sax.Attributes;

 * <p>Rule implementation that saves a parameter for use by a surrounding
 * <code>CallMethodRule.

* * <p>This parameter may be: * <ul> * <li>an arbitrary Object defined programatically, assigned when the element pattern associated with the Rule is matched * See {@link #ObjectParamRule(int paramIndex, Object param)} * <li>an arbitrary Object defined programatically, assigned if the element pattern AND specified attribute name are matched * See {@link #ObjectParamRule(int paramIndex, String attributeName, Object param)} * </ul> * </p> * * @since 1.4 */ public class ObjectParamRule extends Rule { // ----------------------------------------------------------- Constructors /** * Construct a "call parameter" rule that will save the given Object as * the parameter value. * * @param paramIndex The zero-relative parameter number * @param param the parameter to pass along */ public ObjectParamRule(int paramIndex, Object param) { this(paramIndex, null, param); } /** * Construct a "call parameter" rule that will save the given Object as * the parameter value, provided that the specified attribute exists. * * @param paramIndex The zero-relative parameter number * @param attributeName The name of the attribute to match * @param param the parameter to pass along */ public ObjectParamRule(int paramIndex, String attributeName, Object param) { this.paramIndex = paramIndex; this.attributeName = attributeName; this.param = param; } // ----------------------------------------------------- Instance Variables /** * The attribute which we are attempting to match */ protected String attributeName = null; /** * The zero-relative index of the parameter we are saving. */ protected int paramIndex = 0; /** * The parameter we wish to pass to the method call */ protected Object param = null; // --------------------------------------------------------- Public Methods /** * Process the start of this element. * * @param attributes The attribute list for this element */ public void begin(String namespace, String name, Attributes attributes) throws Exception { Object anAttribute = null; Object parameters[] = (Object[]) digester.peekParams(); if (attributeName != null) { anAttribute = attributes.getValue(attributeName); if(anAttribute != null) { parameters[paramIndex] = param; } // note -- if attributeName != null and anAttribute == null, this rule // will pass null as its parameter! }else{ parameters[paramIndex] = param; } } /** * Render a printable version of this Rule. */ public String toString() { StringBuffer sb = new StringBuffer("ObjectParamRule["); sb.append("paramIndex="); sb.append(paramIndex); sb.append(", attributeName="); sb.append(attributeName); sb.append(", param="); sb.append(param); sb.append("]"); return (sb.toString()); } }

Other Tomcat examples (source code examples)

Here is a short list of links related to this Tomcat source code file:

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller


new blog posts


Copyright 1998-2021 Alvin Alexander,
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.