impl/src/test/java/jakarta/faces/convert/EnumConverterTest.java

/*
 * 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 jakarta.faces.convert;

import jakarta.faces.component.UIInput;
import jakarta.faces.context.FacesContext;

import org.apache.myfaces.test.base.junit.AbstractFacesTestCase;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

/**
 * This testcase test <code>jakarta.faces.convert.EnumConverter</code>.
 */
public class EnumConverterTest extends AbstractFacesTestCase
{
    private enum testEnum
    {
        ITEM1, ITEM2;
        
        @Override
        public String toString()
        {
            // overriding toString() to check if converter uses
            // name() instead of toString() to create the String value.
            return "enum value";
        }
        
    }

    private EnumConverter converter;

    @Override
    @BeforeEach
    public void setUp() throws Exception
    {
        super.setUp();
        converter = new EnumConverter(testEnum.class);
    }

    @Override
    @AfterEach
    public void tearDown() throws Exception
    {
        super.tearDown();
        converter = null;
    }

    /**
     * Test method for
     * {@link jakarta.faces.convert.EnumConverter#getAsObject(FacesContext, jakarta.faces.component.UIComponent, String)}.
     */
    @Test
    public void testGetAsObject()
    {
        UIInput input = new UIInput();
        Object convertedObj = converter.getAsObject(FacesContext.getCurrentInstance(), input, "ITEM2");
        Assertions.assertEquals(convertedObj, testEnum.ITEM2);
    }

    /**
     * Test method for
     * {@link jakarta.faces.convert.EnumConverter#getAsObject(FacesContext, jakarta.faces.component.UIComponent, String)}.
     */
    @Test
    public void testGetAsObjectNull()
    {
        UIInput input = new UIInput();
        Object convertedObj = converter.getAsObject(FacesContext.getCurrentInstance(), input, null);
        Assertions.assertNull(convertedObj);
    }

    /**
     * Test method for
     * {@link jakarta.faces.convert.EnumConverter#getAsObject(FacesContext, jakarta.faces.component.UIComponent, String)}.
     */
    @Test
    public void testGetAsObjectNoEnum()
    {
        UIInput input = new UIInput();
        try
        {
            converter.getAsObject(FacesContext.getCurrentInstance(), input, "NO_ENUM_CONST");
            Assertions.fail("Converter exception should be thrown");
        }
        catch (ConverterException e)
        {
            // should be thrown
        }
    }

    /**
     * Test method for
     * {@link jakarta.faces.convert.EnumConverter#getAsObject(FacesContext, jakarta.faces.component.UIComponent, String)}.
     */
    @Test
    public void testGetAsObjectNoClassSet()
    {
        Converter testConverter = new EnumConverter();
        UIInput input = new UIInput();
        try
        {
            testConverter.getAsObject(FacesContext.getCurrentInstance(), input, "ITEM2");
            Assertions.fail("Converter exception should be thrown");
        }
        catch (ConverterException e)
        {
            // should be thrown
        }
    }

    /**
     * Test method for
     * {@link jakarta.faces.convert.EnumConverter#getAsString(FacesContext, jakarta.faces.component.UIComponent, Enum)}.
     */
    @Test
    public void testGetAsString()
    {
        UIInput input = new UIInput();
        String convertedStr = converter.getAsString(FacesContext.getCurrentInstance(), input, testEnum.ITEM1);
        Assertions.assertEquals(convertedStr, testEnum.ITEM1.name());
    }

    /**
     * Test method for
     * {@link jakarta.faces.convert.EnumConverter#getAsString(FacesContext, jakarta.faces.component.UIComponent, Enum)}.
     */
    @Test
    public void testGetAsStringNull()
    {
        UIInput input = new UIInput();
        String convertedStr = converter.getAsString(FacesContext.getCurrentInstance(), input, null);
        Assertions.assertEquals(convertedStr, "");
    }

    /**
     * Test method for
     * {@link jakarta.faces.convert.EnumConverter#getAsString(FacesContext, jakarta.faces.component.UIComponent, Enum)}.
     */
    @Test
    public void testGetAsStringNoClassSet()
    {
        Converter testConverter = new EnumConverter();
        UIInput input = new UIInput();
        try
        {
            testConverter.getAsString(FacesContext.getCurrentInstance(), input, testEnum.ITEM1);
            Assertions.fail("Converter exception should be thrown");
        }
        catch (ConverterException e)
        {
            // should be thrown
        }
    }
}