Quand utiliser GWT ensureInjected()?

Question

J'ai créé quelques styles dans un CSSResource et il fonctionne bien si j'utilise

GWT.<MyResources>create(MyResources.class).myStyles().ensureInjected(); 

ou non.

Quelqu'un pourrait-il nous éclairer à ce sujet et vous expliquer quand utiliser EnsureInjected ou non?

Merci! Daniel

Answer 1

Bonne question - une situation qui vient à l'esprit est quand vous voulez utiliser des styles de certains stylesheet global dans un modèle de UiBinder - alors vous devez appeler ensureInjected pour ... assurer que les styles sont en effet injecté lorsque vous les référençant (les styles UiBinder "locaux" que vous définissez en XML sont automatiquement injectés).

Vous pouvez le voir utilisé en tant que tel dans le Mail example:

public void onModuleLoad() { 
    // Inject global styles. 
    GWT.<GlobalResources>create(GlobalResources.class).css().ensureInjected(); 

    // Create the UI defined in Mail.ui.xml. 
    DockLayoutPanel outer = binder.createAndBindUi(this); 

    // ...rest of the code 
} 

Notez comment ensureInjected est appelée avant la liaison de l'interface utilisateur.

C'est la seule situation que je sais qui justifie l'utilisation ensureInjected, mais peut-être que j'ai raté quelque chose.

Answer 2

Si vous utilisez UiBinder, l'appel de EnsureInjected est fourni par le tag ui: with. Pour tout autre CSS que vous utilisez dans un bundle client (c.-à-d. Un css legacy exclu) et qui n'est pas déclaré dans un bloc ui: with, vous devez appeler explicitement EnsureInjected.

Answer 3

Comme Christian a dit, l'intérieur le fichier UiBinder ui.xml vous n'avez pas à vous soucier d'invoquer ensureInjected(), les déclarations XML suivantes font le travail:

<ui:with field='myStyle' type='com...MyStyle'/> 

<div class='{myStyle.redBorder}'/> 

Bien sûr, cela suppose que il y a quelque part une interface MyStyle définie:

public interface MyStyle { 
    public String redBorder(); 
} 

maintenant, je suis d'accord avec ith vous que les choses deviennent ennuyeux quand vous avez besoin de manipuler l'CssResource extension en dehors de des modèles UiBinder. Précisément parce que vous devez prendre soin d'appeler ensureInjected() quelque part avant d'utiliser l'instance MyStyle avec vos widgets.

J'utilise personnellement GIN pour injecter des instances d'extensions de CssResource chaque fois que je besoin them.That comme vous pouvez mettre en œuvre un fournisseur de GIN personnalisé assurant que ensureInjected() est appelée sur le CssResource avant de l'injecter. Il y a trois étapes: il impliquées

• Créer une interface pour MyStyle à côté d'un fichier CSS.
  MyStyle.java

  public interface MyStyle { 
      public String redBorder(); 
  } 
  

• MyStyle.

  css

  .redBorder { border: 1px solid red; } 
  

• Expose à travers une extension ClientBundle.
  Resources.java

  public interface Resources extends ClientBundle { 
      @Source("MyStyle.css") 
      public MyStyle style(); 
  } 
  

• Configurer une méthode de fournisseur de GIN pour injecter vos instances de MyStyle.
  ClientModule.java

  public class ClientModule extends AbstractGinModule { 
      @Override 
      protected void configure() { 
      //... 
      } 
  
      @Provides MyStyle createStyle(final Resources resources) { 
       MyStyle style = resources.style(); 
       style.ensureInjected(); 
       return style; 
      } 
  } 
  

Nous injectons en douceur l'instance Resources ci-dessus, ce qui signifie que plus d'un tracas accesseur statique appeler GWT.<Resources>create(Resources.class) partout, juste tout passe par l'injection de GIN.

Après avoir fait que vous pouvez injecter vos instances de MyStyle lorsque vous en avez besoin.
Par exemple (dans un contexte MVP):

private Widget widget; 

@Inject 
public SomeView(final MyStyle style) { 
    //... 
    widget = uiBinder.createAndBindUi(this); 
    widget.addStyleName(style.redBorder()); 
} 

Answer 4

La règle est simple: vous devez appeler ensureInjected() explicitement, à moins que le CssResource est généré à partir d'un <ui:style> dans un modèle de UiBinder (parce que la plupart du temps, vous ne sera pas une poignée sur le produit CssResource.
plus précisément, <ui:with> fournit aucun traitement spécial pour CssResource s.

en outre, quelques widgets prendre un ClientBundle spécifique comme argument d'un constructeur (par exemple CellTable), ils seront ensuite appeler ensureInjected() sur la CssResource qu'ils utilisent.