/* * Copyright (C) 2011 The Guava Authors * * Licensed 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 com.google.common.base; import static com.google.common.base.StandardSystemProperty.JAVA_CLASS_PATH; import static com.google.common.base.StandardSystemProperty.PATH_SEPARATOR; import static com.google.common.truth.Truth.assertThat; import static org.junit.Assert.assertThrows; import com.google.common.annotations.GwtIncompatible; import com.google.common.annotations.J2ktIncompatible; import com.google.common.collect.ImmutableList; import com.google.common.collect.ImmutableSet; import com.google.common.testing.GcFinalization; import com.google.common.testing.NullPointerTester; import com.google.common.testing.SerializableTester; import java.io.File; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.ref.WeakReference; import java.lang.reflect.Field; import java.net.MalformedURLException; import java.net.URL; import java.net.URLClassLoader; import java.util.HashSet; import java.util.Set; import junit.framework.TestCase; /** * Tests for {@link Enums}. * * @author Steve McKay */ @GwtIncompatible @J2ktIncompatible public class EnumsTest extends TestCase { private enum TestEnum { CHEETO, HONDA, POODLE, } private enum OtherEnum {} public void testGetIfPresent() { assertThat(Enums.getIfPresent(TestEnum.class, "CHEETO")).hasValue(TestEnum.CHEETO); assertThat(Enums.getIfPresent(TestEnum.class, "HONDA")).hasValue(TestEnum.HONDA); assertThat(Enums.getIfPresent(TestEnum.class, "POODLE")).hasValue(TestEnum.POODLE); assertThat(Enums.getIfPresent(TestEnum.class, "CHEETO")).isPresent(); assertThat(Enums.getIfPresent(TestEnum.class, "HONDA")).isPresent(); assertThat(Enums.getIfPresent(TestEnum.class, "POODLE")).isPresent(); assertThat(Enums.getIfPresent(TestEnum.class, "CHEETO")).hasValue(TestEnum.CHEETO); assertThat(Enums.getIfPresent(TestEnum.class, "HONDA")).hasValue(TestEnum.HONDA); assertThat(Enums.getIfPresent(TestEnum.class, "POODLE")).hasValue(TestEnum.POODLE); } public void testGetIfPresent_caseSensitive() { assertThat(Enums.getIfPresent(TestEnum.class, "cHEETO")).isAbsent(); assertThat(Enums.getIfPresent(TestEnum.class, "Honda")).isAbsent(); assertThat(Enums.getIfPresent(TestEnum.class, "poodlE")).isAbsent(); } public void testGetIfPresent_whenNoMatchingConstant() { assertThat(Enums.getIfPresent(TestEnum.class, "WOMBAT")).isAbsent(); } @J2ktIncompatible @GwtIncompatible // weak references @AndroidIncompatible // depends on details of GC and classloading public void testGetIfPresent_doesNotPreventClassUnloading() throws Exception { WeakReference shadowLoaderReference = doTestClassUnloading(); GcFinalization.awaitClear(shadowLoaderReference); } // Create a second ClassLoader and use it to get a second version of the TestEnum class. // Run Enums.getIfPresent on that other TestEnum and then return a WeakReference containing the // new ClassLoader. If Enums.getIfPresent does caching that prevents the shadow TestEnum // (and therefore its ClassLoader) from being unloaded, then this WeakReference will never be // cleared. @J2ktIncompatible @GwtIncompatible // weak references private WeakReference doTestClassUnloading() throws Exception { URLClassLoader shadowLoader = new URLClassLoader(getClassPathUrls(), null); @SuppressWarnings("unchecked") Class shadowTestEnum = (Class) Class.forName(TestEnum.class.getName(), false, shadowLoader); assertNotSame(shadowTestEnum, TestEnum.class); // We can't write Set because that is a Set of the TestEnum from the original // ClassLoader. Set shadowConstants = new HashSet<>(); for (TestEnum constant : TestEnum.values()) { Optional result = Enums.getIfPresent(shadowTestEnum, constant.name()); assertThat(result).isPresent(); shadowConstants.add(result.get()); } assertEquals(ImmutableSet.copyOf(shadowTestEnum.getEnumConstants()), shadowConstants); Optional result = Enums.getIfPresent(shadowTestEnum, "blibby"); assertThat(result).isAbsent(); return new WeakReference<>(shadowLoader); } @GwtIncompatible // stringConverter public void testStringConverter_convert() { Converter converter = Enums.stringConverter(TestEnum.class); assertEquals(TestEnum.CHEETO, converter.convert("CHEETO")); assertEquals(TestEnum.HONDA, converter.convert("HONDA")); assertEquals(TestEnum.POODLE, converter.convert("POODLE")); assertNull(converter.convert(null)); assertNull(converter.reverse().convert(null)); } @GwtIncompatible // stringConverter public void testStringConverter_convertError() { Converter converter = Enums.stringConverter(TestEnum.class); assertThrows(IllegalArgumentException.class, () -> converter.convert("xxx")); } @GwtIncompatible // stringConverter public void testStringConverter_reverse() { Converter converter = Enums.stringConverter(TestEnum.class); assertEquals("CHEETO", converter.reverse().convert(TestEnum.CHEETO)); assertEquals("HONDA", converter.reverse().convert(TestEnum.HONDA)); assertEquals("POODLE", converter.reverse().convert(TestEnum.POODLE)); } @J2ktIncompatible @GwtIncompatible // stringConverter public void testStringConverter_nullPointerTester() throws Exception { Converter converter = Enums.stringConverter(TestEnum.class); NullPointerTester tester = new NullPointerTester(); tester.testAllPublicInstanceMethods(converter); } @GwtIncompatible // stringConverter public void testStringConverter_nullConversions() { Converter converter = Enums.stringConverter(TestEnum.class); assertNull(converter.convert(null)); assertNull(converter.reverse().convert(null)); } @J2ktIncompatible @GwtIncompatible // Class.getName() public void testStringConverter_toString() { assertEquals( "Enums.stringConverter(com.google.common.base.EnumsTest$TestEnum.class)", Enums.stringConverter(TestEnum.class).toString()); } @GwtIncompatible // stringConverter public void testStringConverter_serialization() { SerializableTester.reserializeAndAssert(Enums.stringConverter(TestEnum.class)); } @J2ktIncompatible @GwtIncompatible // NullPointerTester public void testNullPointerExceptions() { NullPointerTester tester = new NullPointerTester(); tester.testAllPublicStaticMethods(Enums.class); } @Retention(RetentionPolicy.RUNTIME) private @interface ExampleAnnotation {} private enum AnEnum { @ExampleAnnotation FOO, BAR } @J2ktIncompatible @GwtIncompatible // reflection public void testGetField() { Field foo = Enums.getField(AnEnum.FOO); assertEquals("FOO", foo.getName()); assertTrue(foo.isAnnotationPresent(ExampleAnnotation.class)); Field bar = Enums.getField(AnEnum.BAR); assertEquals("BAR", bar.getName()); assertFalse(bar.isAnnotationPresent(ExampleAnnotation.class)); } @J2ktIncompatible @GwtIncompatible // Class.getClassLoader() private URL[] getClassPathUrls() { ClassLoader classLoader = getClass().getClassLoader(); return classLoader instanceof URLClassLoader ? ((URLClassLoader) classLoader).getURLs() : parseJavaClassPath().toArray(new URL[0]); } /** * Returns the URLs in the class path specified by the {@code java.class.path} {@linkplain * System#getProperty system property}. */ // TODO(b/65488446): Make this a public API. @J2ktIncompatible @GwtIncompatible private static ImmutableList parseJavaClassPath() { ImmutableList.Builder urls = ImmutableList.builder(); for (String entry : Splitter.on(PATH_SEPARATOR.value()).split(JAVA_CLASS_PATH.value())) { try { try { urls.add(new File(entry).toURI().toURL()); } catch (SecurityException e) { // File.toURI checks to see if the file is a directory urls.add(new URL("file", null, new File(entry).getAbsolutePath())); } } catch (MalformedURLException e) { AssertionError error = new AssertionError("malformed class path entry: " + entry); error.initCause(e); throw error; } } return urls.build(); } }