19f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/* 29f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Licensed to the Apache Software Foundation (ASF) under one 39f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * or more contributor license agreements. See the NOTICE file 49f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * distributed with this work for additional information 59f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * regarding copyright ownership. The ASF licenses this file 69f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * to you under the Apache License, Version 2.0 (the "License"); 79f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * you may not use this file except in compliance with the License. 89f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * You may obtain a copy of the License at 99f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 109f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * http://www.apache.org/licenses/LICENSE-2.0 119f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 129f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Unless required by applicable law or agreed to in writing, software 139f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * distributed under the License is distributed on an "AS IS" BASIS, 149f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 159f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * See the License for the specific language governing permissions and 169f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * limitations under the License. 179f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 189f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/* 199f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * $Id: StringBufferPool.java 468655 2006-10-28 07:12:06Z minchau $ 209f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 219f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonpackage org.apache.xml.utils; 229f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 239f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson/** 249f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * This class pools string buffers, since they are reused so often. 259f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * String buffers are good candidates for pooling, because of 269f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * their supporting character arrays. 279f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @xsl.usage internal 289f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 299f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilsonpublic class StringBufferPool 309f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson{ 319f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 329f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** The global pool of string buffers. */ 339f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson private static ObjectPool m_stringBufPool = 349f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson new ObjectPool(org.apache.xml.utils.FastStringBuffer.class); 359f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 369f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 379f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Get the first free instance of a string buffer, or create one 389f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * if there are no free instances. 399f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 409f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @return A string buffer ready for use. 419f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 429f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public synchronized static FastStringBuffer get() 439f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 449f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson return (FastStringBuffer) m_stringBufPool.getInstance(); 459f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 469f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson 479f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson /** 489f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * Return a string buffer back to the pool. 499f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * 509f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson * @param sb Must be a non-null reference to a string buffer. 519f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson */ 529f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson public synchronized static void free(FastStringBuffer sb) 539f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson { 549f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson // Since this isn't synchronized, setLength must be 559f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson // done before the instance is freed. 569f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson // Fix attributed to Peter Speck <speck@ruc.dk>. 579f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson sb.setLength(0); 589f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson m_stringBufPool.freeInstance(sb); 599f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson } 609f8118474e9513f7a5b7d2a05e4a0fb15d1a6569Jesse Wilson} 61