多个“主题”的ClientBundle

Question

我们有一个web应用程序，需要为每个主要客户不同的主题。最初的开发人员通过查看javascript中的URL并添加样式表来覆盖默认主题，从而实现了这一点。

这样做的一个问题是，网站的默认外观会持续几秒钟，然后突然切换到正确的主题。另一个原因是它似乎浪费了大量的带宽/时间。

我现在的想法是创建一个具有默认外观的“默认”ClientBundle，扩展该接口，并(根据需要)使用各种注释(如@ImageResouce )和指向不同位置的客户端图像覆盖每个条目。

有没有人有这样做的经验？我看到的一个问题是无法使用uibinder样式标记，因为它们静态地指向特定的资源包。

有什么想法吗？

Answer 1

覆盖的捆绑包

是的你可以。

我已经用ClientBundles做了覆盖的事情，并且工作得很好。你必须做的一件事就是继承属性的类型。举个例子：

BigBundle {
  Nestedundle otherBundle();
  ImageResource otherImage();
  Styles css();
}

然后你必须以这种方式继承：

OtherBigBundle extends BigBundle {
  OtherNestedBundle otherBundle(); // if you want to change it
  ImageResource otherImage(); // of you want to change it
  OtherStyles css(); // of you want to change it
}

以及OtherNestedBundle extends NestedBundle和OtherStyles extends Styles

至少使用CSS的：，如果属性被声明为不使用子接口，它们将为相同的类名生成样式，并且所有样式都将被混合。因此用子接口声明覆盖的样式:)

Flexible UIBinders

如果使用UiField(provided=true)注释，则可以从捆绑包外部设置要使用的内容。通过这种方式，您首先设置包，然后调用uibindler。它将使用资源字段，假设它已经创建。

延迟绑定

您可以使用GWT.runAsync加载正确的包。

一些示例

The ui.xml

<ui:with field='res' type='your.package.TheBundle'/>

相应的类

@UiField(provided=true) TheBundle bundle;

private void createTheThing() {
  this.bundle = factory.createBundle();
  MyUiBindler binder = GWT.create(MyUiBindler.class);
  this.panel = binder.createAndBindUi(this);
  ...
}

一些捆绑包接口

interface TheBundle extends ClientBundle {
  @ImageResource("default.png")
  ImageResource image1();

  @Source("default.css")
  TheCss css();
}

interface Theme1Bundle extends TheBundle {
  @ImageResource("one.png")
  ImageResource image1(); // type: imageresource is ok

  @Source("one.css")
  OneCss css(); // type: OneCss => use other compiled css class-names

  interface OneCss extends TheCss { // inner-interface, just for fun
     // don't need to declare each String method
  }
}

如果你不覆盖某些东西，那也没关系

捆绑包工厂的选项

1)只是完全的

if (...) {
  return GWT.create(TheBundle.class);
} else if (...) {
  return GWT.create(Theme1Bundle.class);
}

2) runAsync (只需加载需要的部分...但在执行初始部分之后)

if (...) {
   GWT.runAsync(new RunAsyncCallback() {
      public void onSuccess() {
        return GWT.create(TheBundle.class);
      }
      // please program the onFailure method
   });
} else if (...) {
   GWT.runAsync(new RunAsyncCallback() {
      public void onSuccess() {
        return GWT.create(Theme1Bundle.class);
      }
      // please program the onFailure method
   });
}

3)使用延迟绑定和生成器在编译时基于带注释的包(如@ThemeBundle("one") )自动生成工厂

这个例子来自真实世界。我使用DynamicEntryPointWidgetFactory (简称DEPWidgetFactory)基于标识符字符串创建小部件。每个widget都是一个应用程序屏幕，每个主菜单项都有它必须创建的widgetName。

在本例中，id将是要创建的主题。

重要提示：如果您使用runAsync，则不能像前面的示例代码那样在创建UI之前创建资源包。您必须请求主题，当它准备好时(在回调中)，将其传递给您的小部件构造函数，您的小部件可以将其分配给它的字段。

出厂接口：

public interface DynamicEntryPointWidgetFactory
{
   public void buildWidget(String widgetName, AsyncCallback<Widget> callback);
}

小部件要生成的注释：

@Target(ElementType.TYPE)
public @interface EntryPointWidget 
{
    /**
     * The name wich will be used to identify this widget.
     */
    String value();
}

模块配置：

它说:工厂的实现将使用这个类生成(另一个选项是使用replace- with，但在我们的例子中，我们没有为每个地区或浏览器预定义选项，而是一些更动态的选项)。

<generate-with class="com.dia.nexdia.services.gwt.rebind.entrypoint.DynamicEntryPointFactoryGenerator">
  <when-type-assignable class="com.dia.nexdia.services.gwt.client.entrypoint.DynamicEntryPointWidgetFactory" />
</generate-with>

生成器：

public class DynamicEntryPointFactoryGenerator extends Generator {
    @Override
    public String generate(TreeLogger logger, GeneratorContext context,
            String typeName) throws UnableToCompleteException {
        PrintWriter pw = context.tryCreate(logger,
                "x.services.gwt.client.entrypoint",
                "DynamicEntryPointWidgetFactoryImpl");

        if (pw != null) {
            // write package, imports, whatever
            pw.append("package x.services.gwt.client.entrypoint;");
            pw.append("import x.services.gwt.client.entrypoint.DynamicEntryPointWidgetFactory;");
            pw.append("import com.google.gwt.core.client.GWT;");
            pw.append("import com.google.gwt.core.client.RunAsyncCallback;");
            pw.append("import com.google.gwt.user.client.rpc.AsyncCallback;");
            pw.append("import com.google.gwt.user.client.ui.Widget;");

            // the class
            pw.append("public class DynamicEntryPointWidgetFactoryImpl implements DynamicEntryPointWidgetFactory {");

            // buildWidget method
            pw.append("   public void buildWidget(String widgetName, final AsyncCallback<Widget> callback) {");

            // iterates over all the classes to find those with EntryPointWidget annotation
            TypeOracle oracle = context.getTypeOracle();
            JPackage[] packages = oracle.getPackages();
            for (JPackage pack : packages) 
            {
                JClassType[] classes = pack.getTypes();
                for (JClassType classtype : classes) 
                {
                    EntryPointWidget annotation = classtype.getAnnotation(EntryPointWidget.class);
                    if (annotation != null) 
                    {
                        String fullName = classtype.getQualifiedSourceName();
                        logger.log(TreeLogger.INFO, "Entry-point widget found: " + fullName);

                        pw.append("if (\"" + annotation.value() + "\".equals(widgetName)) {");
                        pw.append("   GWT.runAsync(" + fullName + ".class, new RunAsyncCallback() {");
                        pw.append("      public void onFailure(Throwable t) {");
                        pw.append("         callback.onFailure(t);");
                        pw.append("      }");
                        pw.append("      public void onSuccess() {");
                        pw.append("         callback.onSuccess(new " + fullName + "());");
                        pw.append("      }");
                        pw.append("   });");
                        pw.append("   return;");
                        pw.append("}");
                    }
                }
            }
            pw.append("callback.onFailure(new IllegalArgumentException(\"Widget '\" + widgetName + \"' not recognized.\"));");

            pw.append("   }");
            pw.append("}");

            context.commit(logger, pw);         
        }

        // return the name of the generated class
        return "x.services.gwt.client.entrypoint.DynamicEntryPointWidgetFactoryImpl";
    }