1 /* 2 3 Derby - Class org.apache.derby.iapi.services.i18n.LocaleFinder 4 5 Licensed to the Apache Software Foundation (ASF) under one or more 6 contributor license agreements. See the NOTICE file distributed with 7 this work for additional information regarding copyright ownership. 8 The ASF licenses this file to you under the Apache License, Version 2.0 9 (the "License"); you may not use this file except in compliance with 10 the License. You may obtain a copy of the License at 11 12 http://www.apache.org/licenses/LICENSE-2.0 13 14 Unless required by applicable law or agreed to in writing, software 15 distributed under the License is distributed on an "AS IS" BASIS, 16 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 17 See the License for the specific language governing permissions and 18 limitations under the License. 19 20 */ 21 22 package org.apache.derby.iapi.services.i18n; 23 24 import org.apache.derby.iapi.error.StandardException; 25 26 import java.util.Locale; 27 import java.text.DateFormat; 28 import java.text.RuleBasedCollator; 29 30 /** 31 A LocaleFinder gets a Locale and things associated with Locales. 32 */ 33 public interface LocaleFinder { 34 35 /** 36 * @exception StandardException Thrown on error 37 */ 38 Locale getCurrentLocale() throws StandardException; 39 40 /** 41 * Get a RuleBasedCollator corresponding to the Locale returned by 42 * getCurrentLocale(). 43 * 44 * @exception StandardException Thrown on error 45 */ 46 RuleBasedCollator getCollator() throws StandardException; 47 48 /** 49 * Get a formatter for formatting dates. The implementation may cache this 50 * value, since it never changes for a given Locale. 51 * 52 * @exception StandardException Thrown on error 53 */ 54 DateFormat getDateFormat() throws StandardException; 55 56 /** 57 * Get a formatter for formatting times. The implementation may cache this 58 * value, since it never changes for a given Locale. 59 * 60 * @exception StandardException Thrown on error 61 */ 62 DateFormat getTimeFormat() throws StandardException; 63 64 65 /** 66 * Get a formatter for formatting timestamps. The implementation may cache 67 * this value, since it never changes for a given Locale. 68 * 69 * @exception StandardException Thrown on error 70 */ 71 DateFormat getTimestampFormat() throws StandardException; 72 } 73