Module java.base
Package java.text.spi

# Class CollatorProvider

java.lang.Object
java.util.spi.LocaleServiceProvider
java.text.spi.CollatorProvider

public abstract class CollatorProvider extends LocaleServiceProvider
An abstract class for service providers that provide concrete implementations of the `Collator` class.

Since:
  1.6

## Constructor Summary

Constructors
Modifier
Constructor
Description
`protected`
`CollatorProvider()`
Sole constructor.

## Method Summary

Modifier and Type
Method
Description
`abstract Collator`
`getInstance(Locale locale)`
Returns a new `Collator` instance for the specified locale.

### Methods declared in class java.util.spi.LocaleServiceProvider

`getAvailableLocales, isSupportedLocale`

### Methods declared in class java.lang.Object

`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

## Constructor Details

### CollatorProvider

protected CollatorProvider()
Sole constructor. (For invocation by subclass constructors, typically implicit.)

## Method Details

### getInstance

public abstract Collator getInstance(Locale locale)
Returns a new `Collator` instance for the specified locale.

Parameters:
  `locale` - the desired locale.
Returns:
  the `Collator` for the desired locale.
Throws:
  `NullPointerException` - if `locale` is null
  `IllegalArgumentException` - if `locale` isn't one of the locales returned from `getAvailableLocales()`.
See Also:
  - `Collator.getInstance(java.util.Locale)`