1 /* 2 * Licensed to the Apache Software Foundation (ASF) under one 3 * or more contributor license agreements. See the NOTICE file 4 * distributed with this work for additional information 5 * regarding copyright ownership. The ASF licenses this file 6 * to you under the Apache License, Version 2.0 (the "License"); 7 * you may not use this file except in compliance with the License. 8 * You may obtain a copy of the License at 9 * 10 * http://www.apache.org/licenses/LICENSE-2.0 11 * 12 * Unless required by applicable law or agreed to in writing, software 13 * distributed under the License is distributed on an "AS IS" BASIS, 14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 15 * See the License for the specific language governing permissions and 16 * limitations under the License. 17 */ 18 /* 19 * $Id: XMLStringFactoryImpl.java 468655 2006-10-28 07:12:06Z minchau $ 20 */ 21 package org.apache.xpath.objects; 22 23 import org.apache.xml.utils.FastStringBuffer; 24 import org.apache.xml.utils.XMLString; 25 import org.apache.xml.utils.XMLStringFactory; 26 27 /** 28 * Class XMLStringFactoryImpl creates XString versions of XMLStrings. 29 * @xsl.usage internal 30 */ 31 public class XMLStringFactoryImpl extends XMLStringFactory 32 { 33 /** The XMLStringFactory to pass to DTM construction. */ 34 private static XMLStringFactory m_xstringfactory = 35 new XMLStringFactoryImpl(); 36 37 /** 38 * Get the XMLStringFactory to pass to DTM construction. 39 * 40 * 41 * @return A never-null static reference to a String factory. 42 */ getFactory()43 public static XMLStringFactory getFactory() 44 { 45 return m_xstringfactory; 46 } 47 48 /** 49 * Create a new XMLString from a Java string. 50 * 51 * 52 * @param string Java String reference, which must be non-null. 53 * 54 * @return An XMLString object that wraps the String reference. 55 */ newstr(String string)56 public XMLString newstr(String string) 57 { 58 return new XString(string); 59 } 60 61 /** 62 * Create a XMLString from a FastStringBuffer. 63 * 64 * 65 * @param fsb FastStringBuffer reference, which must be non-null. 66 * @param start The start position in the array. 67 * @param length The number of characters to read from the array. 68 * 69 * @return An XMLString object that wraps the FastStringBuffer reference. 70 */ newstr(FastStringBuffer fsb, int start, int length)71 public XMLString newstr(FastStringBuffer fsb, int start, int length) 72 { 73 return new XStringForFSB(fsb, start, length); 74 } 75 76 /** 77 * Create a XMLString from a FastStringBuffer. 78 * 79 * 80 * @param string FastStringBuffer reference, which must be non-null. 81 * @param start The start position in the array. 82 * @param length The number of characters to read from the array. 83 * 84 * @return An XMLString object that wraps the FastStringBuffer reference. 85 */ newstr(char[] string, int start, int length)86 public XMLString newstr(char[] string, int start, int length) 87 { 88 return new XStringForChars(string, start, length); 89 } 90 91 /** 92 * Get a cheap representation of an empty string. 93 * 94 * @return An non-null reference to an XMLString that represents "". 95 */ emptystr()96 public XMLString emptystr() 97 { 98 return XString.EMPTYSTRING; 99 } 100 101 } 102