问题：

从Vaadin 7中的枚举创建OptionGroup（单选按钮）？

殳阳飙

2023-03-14

我有一个Java枚举，带有所需显示文本的getter。如何使用它在Vaadin 7中填充OptionGroup？

共有2个答案

余天宇

2023-03-14

Viritin是Vaadin的一个插件，它有一个非常方便的字段，名为EnumSelect。它可以从编辑的特性中自动检测可用特性。您也可以只传递在UI上显示为标题的策略。

基本用途

    EnumSelect<AddressType> select = new EnumSelect<AddressType>()
            .withSelectType(OptionGroup.class);
    select.setStyleName(ValoTheme.OPTIONGROUP_HORIZONTAL);

    // The Enum type is detected when the edited property is bound to select
    // This typically happens via basic bean binding, but here done manually.
    ObjectProperty objectProperty = new ObjectProperty(AddressType.Home);
    select.setPropertyDataSource(objectProperty);

    // Alternatively, if not using databinding at all, you could just use 
    // basic TypedSelect, or the method from it
    // select.setOptions(AddressType.values());

请注意，当前版本的键入有限。我刚刚修复了这个问题，显示的类型化api将在下一个版本中发布。

司寇善

2023-03-14

在Vaadin 7中，有三种方法可以做到这一点：

我构建的一个类，EnumBackedOptionGroup。Vaadin 7中OptionGroup的一个子类

下面是我编写的OptionGroup的一个新子类的源代码。

package com.basilbourque;

import com.vaadin.ui.OptionGroup;
import java.util.Arrays;
import java.util.Collection;
import java.util.function.Function;
import org.slf4j.LoggerFactory;

/**
 * A subclass of the Vaadin 7 OptionGroup (radio buttons or bunch of checkboxes) widget, taking as its set of options
 * the instances of an Enum.
 *
 * In canonical usage, pass the class of your Enum and a reference to the method to be called for obtaining a textual
 * label for display to the user.
 *
 * Alternatively, if your Enum overrides the `toString` method, you may pass only the class of the Enum without a
 * Function. This approach is not recommended per the class documentation which explains `toString` should only be used
 * for debugging message. Nevertheless, some people override `toString` to provide a user-readable label, so we support
 * this.
 *
 * Even if your Enum does not override `toString` you may choose to omit passing the Function argument. As a default,
 * the Enum’s built-in `toString` method will be called, returning the "name" of the Enum’s instance. This is handy for
 * quick-and-dirty prototyping. Again, neither I nor the class doc recommend this approach for serious work.
 *
 * If you want to display a subset of your enum’s instances rather than all, pass a Collection.
 *
 * This source code available under terms of ISC License.  https://en.wikipedia.org/wiki/ISC_license
 * 
 * Copyright (c) 2015, Basil Bourque
 * Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby
 * granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS
 * PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT,
 * OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
 * SOFTWARE.
 *
 * @author Basil Bourque
 * @version 2015-08-27T21:00:00Z
 * @since 2015-08-27T21:00:00Z
 */
public class EnumBackedOptionGroup<T extends Enum> extends OptionGroup
{

    final org.slf4j.Logger logger = LoggerFactory.getLogger( this.getClass() );

    /**
     * Constructor. The usual constructor for automatically detecting all the instances of an enum for use as the
     * options in a Vaadin 7 OptionGroup. Pass a function to be called for providing each option’s displayed labeling.
     *
     * Example usage:
     *
     * myRadios = new EnumBackedOptionGroup<DogBreed>( "Choose breed:" , DogBreed.class , DogBreed :: getTitle );
     *
     * @param caption
     * @param enumClass
     * @param f
     */
    public EnumBackedOptionGroup ( final String caption , final Class<T> enumClass , final Function<T , String> f ) {
        super( caption );
        Function<T , String> func = f;
        // If passed a null for the Function, fallback to using 'toString'.
        if ( func == null ) {
            func = T -> T.toString();
        }
        this.buildAndAssignCaptions( enumClass , func );
    }

    /**
     * Constructor. Similar to usual constructor, but here you may additionally pass a Collection of the subset of Enum
     * instances.
     *
     * For use where business logic dictates that you give only some of the Enum values an options rather than all of
     * them. The omitted options are effectively hidden from the user.
     *
     * @param caption
     * @param enumClass
     * @param enumValues
     * @param f
     */
    public EnumBackedOptionGroup ( final String caption , final Class<T> enumClass , final Collection<T> enumValues , final Function<T , String> f ) {
        super( caption );
        Function<T , String> func = f;
        // If passed a null for the Function, fallback to using 'toString'.
        if ( func == null ) {
            func = T -> T.toString();
        }
        Collection<T> ev = enumValues;
        // Handle where calling method passed us a null or empty collection.
        if ( ( ev == null ) || ev.isEmpty() ) {
            this.buildAndAssignCaptions( enumClass , f ); // Fallback to assiging all the instances of enum as options in our OptionGroup.
        } else {
            this.addItems( enumValues );  // Add the passed subset of instances of the enum as items backing our OptionGroup.
            this.assignCaptions( enumValues , f );
        }
    }

    /**
     * Constructor. Similar to the usual constructor, but omits the method for providing on-screen labeling. Instead
     * uses the 'toString' method defined either explicitly in the Enum subclass or implicitly calls to the Enum class’
     * own 'toString'.
     *
     * Not recommended, as the Enum documentation strongly suggests the 'toString' method on an Enum be used only for
     * debugging. Nevertheless this is handy for quick-and-dirty prototyping.
     *
     * @param caption
     * @param enumClass
     */
    public EnumBackedOptionGroup ( final String caption , final Class<T> enumClass ) {
        super( caption );
        // User passed no Function to call for getting the title. So fallback to using 'toString'.
        this.buildAndAssignCaptions( enumClass , T -> T.toString() );
    }

    // Helper method. (sub-routine)
    // Extracts all the instances of the enum, and uses them as options in our OptionGroup.
    // Also assigns each option a labeling using String returned by passed method to be called for each instance of enum.
    private void buildAndAssignCaptions ( final Class<T> enumClass , final Function<T , String> f ) {
        if ( enumClass.isEnum() ) {  // This check may be unnecessary with Generics code "<T extends Enum>" at top of this class.
            Collection<T> enumValues = Arrays.asList( enumClass.getEnumConstants() );
            this.addItems( enumValues );  // Add all the instances of the enum as items backing our OptionGroup.
            this.assignCaptions( enumValues , f );
        } else {
            // Else the passed class is not an enum.
            // This case should not be possible because of the Generics marked on this class "<T extends Enum>".
            logger.error( "Passed a class that is not a subclass of Enum. Message # f2098672-ab47-47fe-b720-fd411411052e." );
            throw new IllegalArgumentException( "Passed a class that is not a subclass of Enum." );
        }
    }

    // Helper method. (sub-routine)
    // Assigns each option a labeling using String returned by passed method to be called for each instance of enum
    private void assignCaptions ( Collection<T> enumValues , final Function<T , String> f ) {
        for ( T option : enumValues ) {
            // For each option in our OptionGroup, determine and set its title, the label displayed for the user next to each radio button or checkbox.
            // To determine the label (the second argument), we invoke the passed method which must return a String. Using Lambda syntax.
            this.setItemCaption( option , f.apply( option ) );
        }
    }

}

我希望您可以使用像这样的枚举，狗种。请注意，此枚举如何具有一个构造函数，在该构造函数中，我们将文本作为标签传递给用户，以供演示。我们添加了一个方法来检索这个标题文本。

package com.example;

/**
 * Bogus example Enum.
 */
public enum DogBreed {

    AUSSIE("Australian Shepherd") ,
    BORDER_COLLIE("Border Collie"),
    BLACK_LAB("Labrador, Black"),
    MUTT("Mixed Breed");

    private String title = null;

    DogBreed ( final String titleArg) {
        this.title = titleArg;
    }

    public String getTitle() {
        return this.title;
    }

}

多亏了WillShackleford对我的问题的回答，我才能完成那个类，Lambda语法传递和调用方法引用。

要使用这个EnumBackedGroupOption类，请传递它的类和该标题呈现方法的方法引用。这需要Java8中的新Lambda语法。但是还不需要掌握您对Lambda的理解，只需遵循您在这里看到的模式。

OptionGroup optionGroup = new EnumBackedOptionGroup<DogBreed>( "Choose Breed:" , DogBreed.class , DogBreed :: getTitle );

为了快速而脏的原型设计，您可以定义一个简单的枚举，而不需要这样的构造函数和getter。在本例中，只传递标题和枚举类。EnumBackedOptionGroup类使用内置的toString方法。我和Enum类文档都不建议将此路径用于只应用于调试的严肃工作。

package com.example;

/**
 * Bogus example Enum.
 */
public enum SaySo {

    YES, NO, MAYBE;
}

OptionGroup optionGroup = new EnumBackedOptionGroup<SaySo>( "Says you:" , SaySo.class );

有时，您可能不想在OptionGroup中使用所有枚举的实例值。如果是这样，请使用本问题中解释的隐式方法value提取这些实例的集合。删除不需要的。请注意我们如何从Arrays.asList的输出实例化一个新的ArrayList以允许此修改。然后将该集合传递给EnumBackedOptionGroup的另一个构造函数。

您可以将null作为最后一个参数传递，以使用toString作为演示文稿标记。

您可以使用枚举映射或枚举集来代替。值，但我没有这方面的经验。

Collection<T> enumValues = new ArrayList( Arrays.asList( SaySo.values() ) );
enumValues.remove( SaySo.MAYBE );
OptionGroup optionGroup = new EnumBackedOptionGroup<SaySo>( "Says you:" , SaySo.class , null );

想象一下这个嵌套在SomeClass中的CRITTER\u过滤器。

public enum CRITTER_FILTER
{

    CANINE ( "Dogs" ), // Pass the text to be displayed to user as the radio button’s Caption (label).
    FELINE ( "Cats" ),
    COCKATIEL ( "Cockatiel birds" );

    private String title;

    CRITTER_FILTER ( String t )
    {
        this.title = t;
    }

    // Add this method for the more flexible approach.
    // JavaBeans "getter" for use in BeanItemContainer.
    public String getTitle ()
    {
        return this.title;
    }

    // Add this method for the short simple approach.
    @Override
    public String toString ()
    {
        return this.title;
    }

}

添加构造函数使我们能够将所需的显示文本传递给每个枚举实例，然后将该文本存储在私有成员String变量中。

如果在确定显示文本时没有什么特别的工作要做，只需重写toString方法即可返回存储的显示文本。

我不推荐这种方法。只有当您想创建一个特殊值以便在调试工作中显示给程序员时，文档才建议重写字符串。然而，我确实尝试过这种方法，它确实有效。

公共字符串toString（）

…此方法可能会被重写，尽管它通常不是必需的或可取的。当存在更“程序员友好”的字符串形式时，枚举类型应重写此方法。

this.filterRadios = new OptionGroup( "Filter:" , Arrays.asList( SomeClass.CRITTER_FILTER.values() ) );  // Convert plain array of the enum instances (the values) into a `Collection` object by calling utility method `Arrays.asList`.
this.filterRadios.setMultiSelect( false ); // Radio buttons are single-select.

带有嵌套枚举的Person类。

package com.example.vaadinradiobuttons;

import java.util.ArrayList;
import java.util.List;

/**
 *
 * @author Basil Bourque
 */
public class Person {

    // Members
    String name;
    Person.VITAL_STATUS vitalStatus;

    public enum VITAL_STATUS {

        LIVING( "Alive and Kicking" ),
        DECEASED( "Dead" ),
        UNKNOWN( "DUNNO" );

        private String captionText;

        VITAL_STATUS ( String t ) {
            this.captionText = t;
        }

        @Override
        public String toString () {
            return this.captionText;
        }

    }

    // Constructor
    public Person ( String nameArg , VITAL_STATUS vitalStatusArg ) {
        this.name = nameArg;
        this.vitalStatus = vitalStatusArg;
    }

}

还有一个小小的Vaadin 7.4.3应用程序，使用该嵌套枚举填充选项组。查找示例的注释核心以查看重要行。

package com.example.vaadinradiobuttons;

import javax.servlet.annotation.WebServlet;

import com.vaadin.annotations.Theme;
import com.vaadin.annotations.VaadinServletConfiguration;
import com.vaadin.annotations.Widgetset;
import com.vaadin.data.Property;
import com.vaadin.server.VaadinRequest;
import com.vaadin.server.VaadinServlet;
import com.vaadin.ui.OptionGroup;
import com.vaadin.ui.UI;
import com.vaadin.ui.VerticalLayout;
import java.util.Arrays;
import java.util.Collection;

/**
 *
 */
@Theme ( "mytheme" )
@Widgetset ( "com.example.vaadinradiobuttons.MyAppWidgetset" )
public class MyUI extends UI {

    @Override
    protected void init ( VaadinRequest vaadinRequest ) {
        final VerticalLayout layout = new VerticalLayout();
        layout.setMargin( true );
        setContent( layout );

        // Core of example.
        Collection<Person.VITAL_STATUS> v = Arrays.asList( Person.VITAL_STATUS.values() );
        OptionGroup radios = new OptionGroup( "Vital Status :" , v );
        radios.setImmediate( true );
        radios.addValueChangeListener( ( Property.ValueChangeEvent event ) -> {
            Person.VITAL_STATUS vitalStatus = ( Person.VITAL_STATUS ) event.getProperty().getValue();
            System.out.println( "User selected a vital status name: " + vitalStatus.name() + ", labeled: " + vitalStatus.toString() );
        } );
        layout.addComponent( radios );

    }

    @WebServlet ( urlPatterns = "/*" , name = "MyUIServlet" , asyncSupported = true )
    @VaadinServletConfiguration ( ui = MyUI.class , productionMode = false )
    public static class MyUIServlet extends VaadinServlet {
    }
}

请注意，在上面的枚举中添加了getTitle方法。除了已在Java中定义为枚举的一部分之外，您可以使用任何想要的方法名称。

创建一个BeanItemContainer，填充枚举的实例，并告诉Vaadin提供显示文本的“属性”（用于反射性地查找匹配的getter方法）的名称。

除了更加灵活之外，考虑到doc对重写字符串的警告，这种方法可能更明智。

BeanItemContainer<SomeClass.CRITTER_FILTER> radiosBic = new BeanItemContainer<SomeClass.CRITTER_FILTER>( SomeClass.CRITTER_FILTER.class );
radiosBic.addAll( Arrays.asList( SomeClass.CRITTER_FILTER.values() ) );  // Convert array of values to a `Collection` object.
this.filterRadios = new OptionGroup( "Critter Filter:" , radiosBic );
this.filterRadios.setMultiSelect( false ); // Radio buttons are single-select.
this.filterRadios.setItemCaptionMode( AbstractSelect.ItemCaptionMode.PROPERTY );  
this.filterRadios.setItemCaptionPropertyId( "title" );  // Matches the getter method defined as part of the enum.

这行得通。我希望它可以在Vaadin 6和7中工作。

让我们调整上一节所示的示例Person和Vaadin应用程序。

在Person类中，将toString方法替换为JavaBeans Property gettergetCaptionText。此方法的名称可以是任何东西，只要它与下面的Vaadin应用程序中看到的对setItemCaptionProperty tyId的调用相匹配。

package com.example.vaadinradiobuttons;

import java.util.ArrayList;
import java.util.List;

/**
 *
 * @author Basil Bourque
 */
public class Person {

    // Members
    String name;
    Person.VITAL_STATUS vitalStatus;

    public enum VITAL_STATUS {

        LIVING( "Alive and Kicking" ),
        DECEASED( "Dead" ),
        UNKNOWN( "DUNNO" );

        private String captionText;
        static public String CAPTION_TEXT_PROPERTY_NAME = "captionText";  //

        VITAL_STATUS ( String t ) {
            this.captionText = t;
        }

        // JavaBeans Property getter.
        public String getCaptionText () {
            return this.captionText;
        }

    }

    // Constructor
    public Person ( String nameArg , VITAL_STATUS vitalStatusArg ) {
        this.name = nameArg;
        this.vitalStatus = vitalStatusArg;
    }

}

Vaadin应用程序更改为使用BeanItemContainer。通过调用setItemCaptionPropertyId，可以指定容器中的哪些属性应用作要显示的文本。

package com.example.vaadinradiobuttons;

import javax.servlet.annotation.WebServlet;

import com.vaadin.annotations.Theme;
import com.vaadin.annotations.VaadinServletConfiguration;
import com.vaadin.annotations.Widgetset;
import com.vaadin.data.Property;
import com.vaadin.data.util.BeanItemContainer;
import com.vaadin.server.VaadinRequest;
import com.vaadin.server.VaadinServlet;
import com.vaadin.ui.OptionGroup;
import com.vaadin.ui.UI;
import com.vaadin.ui.VerticalLayout;
import java.util.Arrays;
import java.util.Collection;

/**
 *
 */
@Theme ( "mytheme" )
@Widgetset ( "com.example.vaadinradiobuttons.MyAppWidgetset" )
public class MyUI extends UI {

    @Override
    protected void init ( VaadinRequest vaadinRequest ) {
        final VerticalLayout layout = new VerticalLayout();
        layout.setMargin( true );
        setContent( layout );

        // Core of example.
        Collection<Person.VITAL_STATUS> v = Arrays.asList( Person.VITAL_STATUS.values() );
        BeanItemContainer<Person.VITAL_STATUS> bic = new BeanItemContainer<>( Person.VITAL_STATUS.class , v );
        OptionGroup radios = new OptionGroup( "Vital Status :" , bic );
        radios.setItemCaptionPropertyId(Person.VITAL_STATUS.CAPTION_TEXT_PROPERTY_NAME );  // …or… ( "captionText" );
        radios.setImmediate( true );
        radios.addValueChangeListener( ( Property.ValueChangeEvent event ) -> {
            Person.VITAL_STATUS vitalStatus = ( Person.VITAL_STATUS ) event.getProperty().getValue();
            System.out.println( "User selected a vital status name: " + vitalStatus.name() + ", labeled: " + vitalStatus.toString() );
        } );
        layout.addComponent( radios );

    }

    @WebServlet ( urlPatterns = "/*" , name = "MyUIServlet" , asyncSupported = true )
    @VaadinServletConfiguration ( ui = MyUI.class , productionMode = false )
    public static class MyUIServlet extends VaadinServlet {
    }
}

从Vaadin 7中的枚举创建OptionGroup（单选按钮）？

共有2个答案

相关问答

相关文章

相关阅读

相关工具

相关文档