/**************************************************************
*
* 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
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*************************************************************/
package api.i18n;
import java.text.Collator;
import java.util.Arrays;
import java.util.Collection;
import com.sun.star.i18n.CollatorOptions;
import com.sun.star.i18n.XCollator;
import com.sun.star.lang.Locale;
import com.sun.star.uno.UnoRuntime;
import com.sun.star.uno.XComponentContext;
import org.junit.AfterClass;
import org.junit.Before;
import org.junit.BeforeClass;
import org.junit.Assert;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.Parameterized;
import org.junit.runners.Parameterized.Parameters;
import org.openoffice.test.uno.UnoApp;
/**
* Testing com.sun.star.i18n.XCollator
* interface methods :
*
* compareSubstring()
* compareString()
* loadDefaultCollator()
* loadCollatorAlgorithm()
* listCollatorAlgorithms()
* loadCollatorAlgorithmWithEndUserOption()
* listCollatorOptions()
*
* Test is NOT multithread compliant.
* @see com.sun.star.i18n.XCollator
*/
@RunWith(Parameterized.class)
public class XCollatorTest {
private static final UnoApp app = new UnoApp();
private String collatorServiceName;
private XComponentContext xContext = null;
private XCollator oObj = null;
private String[] alg = null ;
private int[] opt = null ;
Locale loc = new Locale("en", "EN", "");
// setup and close connections
@BeforeClass
public static void setUpConnection() throws Exception
{
app.start();
}
@AfterClass
public static void tearDownConnection() throws InterruptedException, com.sun.star.uno.Exception
{
app.close();
}
@Parameters(name = "{0}")
public static Collection data() {
return Arrays.asList(new Object[][]{
{"com.sun.star.i18n.Collator"},
{"com.sun.star.i18n.ChapterCollator"}
});
}
public XCollatorTest(String collatorServiceName) {
this.collatorServiceName = collatorServiceName;
}
@Before
public void before() throws Exception, java.lang.Exception
{
xContext = app.getComponentContext();
final Object object = xContext.getServiceManager().createInstanceWithContext(collatorServiceName, xContext);
oObj = UnoRuntime.queryInterface(XCollator.class, object);
alg = oObj.listCollatorAlgorithms(loc);
}
/**
* Just retrieves a list of algorithms.
* Has OK status if non-zero length array returned.
*/
@Test
public void _listCollatorAlgorithms() {
String[] algorithms = oObj.listCollatorAlgorithms(loc) ;
System.out.println("Collator algorithms :");
if (algorithms != null) {
for (int i = 0; i < alg.length; i++) {
System.out.println(" '" + algorithms[i] + "'") ;
}
Assert.assertTrue("listCollatorAlgorithms()", algorithms.length > 0) ;
} else {
Assert.fail("listCollatorAlgorithms()");
}
}
/**
* Just gets a list of options for some collator.
* Has OK status if not null value returned.
* The following method tests are to be completed successfully before :
*
* listCollatorAlgorithms : to have some
* algorithm name.
*
*/
@Test
public void _listCollatorOptions() {
opt = oObj.listCollatorOptions(alg[0]) ;
System.out.println("Collator '" + alg[0] + "' options :");
if (opt != null) {
for (int i = 0; i < opt.length; i++) {
System.out.println(" " + opt[i]) ;
}
Assert.assertTrue("listCollatorOptions()", true) ;
} else {
Assert.fail("listCollatorOptions()") ;
}
}
/**
* Calls the method with no options and with options(IGNORE_CASE),
* compares strings.
* Has OK status if compareString() returned correct values.
*/
@Test
public void _loadDefaultCollator() {
oObj.loadDefaultCollator(loc, 0);
boolean res = oObj.compareString("A", "a") != 0;
oObj.loadDefaultCollator(loc,
CollatorOptions.CollatorOptions_IGNORE_CASE);
res &= oObj.compareString("a", "A") == 0;
Assert.assertTrue("loadDefaultCollator()", res) ;
}
/**
* Calls the method with no options and with options(IGNORE_CASE),
* compares strings.
* Has OK status if compareString() returned correct values.
* The following method tests are to be completed successfully before :
*
* listCollatorAlgorithms : to have some
* algorithm name.
*
*/
@Test
public void _loadCollatorAlgorithm() {
oObj.loadCollatorAlgorithm(alg[0], loc,
CollatorOptions.CollatorOptions_IGNORE_CASE);
boolean res = oObj.compareString("A", "a") == 0;
oObj.loadCollatorAlgorithm(alg[0], loc, 0);
res &= oObj.compareString("a", "A") != 0;
Assert.assertTrue("loadCollatorAlgorithm()", res);
}
/**
* Calls the method with no options and with options(IGNORE_CASE),
* compares strings.
* Has OK status if compareString() returned correct values.
* The following method tests are to be completed successfully before :
*
* listCollatorAlgorithms : to have some
* algorithm name.
*
*/
@Test
public void _loadCollatorAlgorithmWithEndUserOption() {
oObj.loadCollatorAlgorithmWithEndUserOption(alg[0], loc,
new int[] {0});
boolean res = oObj.compareString("A", "a") != 0;
oObj.loadCollatorAlgorithmWithEndUserOption(alg[0], loc,
new int[] {CollatorOptions.CollatorOptions_IGNORE_CASE});
res = oObj.compareString("A", "a") == 0;
Assert.assertTrue("loadCollatorAlgorithmWithEndUserOption()", res);
}
/**
* Test is performed for locales : en, ru, ja, zh, ko.
* Default collator is loaded for each locale. Then collation
* is performed for different combination of symbols from range of
* this locale.
* Has OK status if comparing of different strings
* returns not 0 value, then comparing in the opposite
* order returns value with opposite sign, and comparing
* of two equal strings returns 0. The such comparing is performed
* for one character strings.
*/
@Test
public void _compareSubstring() {
boolean result = true ;
char[] chars = new char[2] ;
Collator col = null ;
System.out.println(" #### Testing English locale ####") ;
oObj.loadDefaultCollator(loc, 0) ;
col = Collator.getInstance(new java.util.Locale("en", "EN")) ;
for (char ch = 0x0020; ch < 0x007F; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareSubstring(chars, col) ;
}
System.out.println(" #### Testing Russian locale ####") ;
oObj.loadDefaultCollator(
new com.sun.star.lang.Locale("ru", "RU", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("ru", "RU")) ;
for (char ch = 0x0410; ch < 0x0450; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareSubstring(chars, col) ;
}
System.out.println(" #### Testing Japan locale ####") ;
oObj.loadDefaultCollator(
new com.sun.star.lang.Locale("ja", "JP", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("ja", "JP")) ;
for (char ch = 0x4E00; ch < 0x4EFD; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareSubstring(chars, col) ;
}
System.out.println(" #### Testing China locale ####") ;
oObj.loadDefaultCollator(new Locale("zh", "CN", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("zh", "CN")) ;
for (char ch = 0x4E00; ch < 0x4EFD; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareSubstring(chars, col) ;
}
System.out.println(" #### Testing Korean locale ####") ;
oObj.loadDefaultCollator(new Locale("ko", "KR", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("ko", "KR")) ;
for (char ch = 0x4E00; ch < 0x4EFD; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareSubstring(chars, col) ;
}
Assert.assertTrue("compareSubstring()", result) ;
}
/**
* Test is performed for locales : en, ru, ja, zh, ko.
* Default collator is loaded for each locale. Then collation
* is performed for different combination of symbols from range of
* this locale.
* Has OK status if comparing of different strings
* returns not 0 value, then comparing in the opposite
* order returns value with opposite sign, and comparing
* of two equal strings returns 0. The such comparing is performed
* for one character strings.
*/
@Test
public void _compareString() {
boolean result = true ;
char[] chars = new char[2] ;
Collator col = null ;
System.out.println(" #### Testing English locale ####") ;
oObj.loadDefaultCollator(
new com.sun.star.lang.Locale("en", "EN", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("en", "EN")) ;
for (char ch = 0x0020; ch < 0x007F; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareString(chars, col) ;
}
System.out.println(" #### Testing Russian locale ####") ;
oObj.loadDefaultCollator(
new com.sun.star.lang.Locale("ru", "RU", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("ru", "RU")) ;
for (char ch = 0x0410; ch < 0x0450; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareString(chars, col) ;
}
System.out.println(" #### Testing Japan locale ####") ;
oObj.loadDefaultCollator(
new com.sun.star.lang.Locale("ja", "JP", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("ja", "JP")) ;
for (char ch = 0x4E00; ch < 0x4EFD; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareString(chars, col) ;
}
System.out.println(" #### Testing China locale ####") ;
oObj.loadDefaultCollator(new Locale("zh", "CN", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("zh", "CN")) ;
for (char ch = 0x4E00; ch < 0x4EFD; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareString(chars, col) ;
}
System.out.println(" #### Testing Korean locale ####") ;
oObj.loadDefaultCollator(new Locale("ko", "KR", ""), 0) ;
col = Collator.getInstance(new java.util.Locale("ko", "KR")) ;
for (char ch = 0x4E00; ch < 0x4EFD; ch ++) {
chars[0] = ch ; chars[1] = (char) (ch + 1) ;
result &= testCompareString(chars, col) ;
}
Assert.assertTrue("compareString()", result) ;
}
/**
* Testing compareString() method. At first method is testing single chars
* comparing, then strings comparing.
* @param locChar sequence of at list two characters of a given locale
* to be used in comparing.
* @param col Collator for a given locale
* @return true if:
*
* if comparing of two identical characters returns zero
* if comparing of two different characters returns non zero
* if comparing of two identical strings, composed of given chars
* returns zero
* if comparing of two different strings, composed of given chars
* returns non zero
*
*/
public boolean testCompareString(char[] locChar, Collator col) {
boolean result = true;
int res;
String msg = "";
String char0 = "_"+new String(new char[] {locChar[0]});
String char1 = "_"+new String(new char[] {locChar[1]});
res = oObj.compareString(char0 , char0) ;
if (res != 0) {
msg += " Testing collation of single equal characters ("
+ toUnicode(char0) + ") ... FAILED\n" ;
}
result &= res == 0 ;
res = oObj.compareString(char0, char1) ;
if (res == 0) {
msg += " Testing collation of single different" +
" characters (" + toUnicode(char0+char1) +
") ... FAILED (0 returned)\n" ;
msg += " Java collator returned " +
col.compare(char0, char1) + "\n" ;
result = false ;
} else { // opposite order - sum of results must be 0
res += oObj.compareString(char1, char0) ;
if (res != 0) {
msg += " Testing collation of single different" +
" characters (" + toUnicode(char0+char1) +
") ... FAILED\n" ;
}
result &= res == 0 ;
}
String str1 = new String(new char[] {locChar[0], locChar[0],
locChar[1], locChar[1], locChar[1]}) ;
String str2 = new String(new char[] {locChar[0], locChar[0],
locChar[0], locChar[1], locChar[1]}) ;
res = oObj.compareString(str1 , str1) ;
if (res != 0) {
msg += " Testing collation of equal strings (" +
toUnicode(str1) + ") ... FAILED\n" ;
}
result &= res == 0 ;
res = oObj.compareString(str1, str2) ;
if (res == 0) {
msg += " Testing collation of different strings ((" +
toUnicode(str1) + "),(" + toUnicode(str2) +
")) ... FAILED (0 returned)\n" ;
msg += " Java collator returned " +
col.compare(str1, str2) + "\n" ;
result = false ;
} else { // opposite order - sum of results must be
res += oObj.compareString(str2, str1) ;
if (res != 0) {
msg += " Testing collation of different strings ((" +
toUnicode(str1) + "),(" + toUnicode(str2) +
")) ... FAILED\n" ;
}
result &= res == 0 ;
}
if (!result) {
System.out.println(msg) ;
}
return result ;
}
/**
* Testing compareSubstring() method. Method is testing substrings comparing.
* @param locChar sequence of at list two characters of a given locale
* to be used in comparing.
* @param col Collator for a given locale
* @return true if:
*
* if comparing of two identical substrings of strings, composed
* of given chars returns zero
* if comparing of two different substrings of strings, composed
* of given chars returns non zero
*
*/
public boolean testCompareSubstring(char[] locChar, Collator col) {
boolean result = true ;
int res ;
String msg = "" ;
String str1 = new String(new char[] {locChar[0], locChar[0],
locChar[1], locChar[1], locChar[1]}) ;
String str2 = new String(new char[] {locChar[0], locChar[0],
locChar[0], locChar[1], locChar[1]}) ;
res = oObj.compareSubstring(str1, 1, 2 , str2, 2, 2) ;
if (res != 0) {
msg += " Testing collation of equal substrings (" +
toUnicode(str1) + ") ... FAILED\n" ;
}
result &= res == 0 ;
res = oObj.compareSubstring(str1, 1, 2, str2, 1, 2) ;
if (res == 0) {
msg += " Testing collation of different strings ((" +
toUnicode(str1.substring(1, 3)) + "),(" +
toUnicode(str2.substring(1, 3))
+ ")) ... FAILED (0 returned)\n" ;
msg += " Java collator returned " + col.compare
(str1.substring(1, 3), str2.substring(1, 3)) + "\n" ;
result = false ;
} else { // opposite order - sum of results must be
res += oObj.compareSubstring(str2, 1, 2, str1, 1, 2) ;
if (res != 0) {
msg += " Testing collation of different strings ((" +
toUnicode(str1) + "),(" + toUnicode(str2) +
")) ... FAILED\n" ;
}
result &= res == 0 ;
}
if (!result) {
System.out.println(msg) ;
}
return result ;
}
/**
* Transforms string to unicode hex codes.
* @param str String to be transformed
*/
public String toUnicode(String str) {
char[] chars = str.toCharArray() ;
String res = "" ;
for (int i = 0; i < chars.length; i++) {
if (i != 0) res += "," ;
res += Integer.toHexString(chars[i]) ;
}
return res ;
}
}