Examples of org.infinispan.marshall.AdvancedExternalizer

org.infinispan.marshall.AdvancedExternalizer

{@link AdvancedExternalizer} provides an alternative way to provideexternalizers for marshalling/unmarshalling user defined classes that overcome the deficiencies of the more user-friendly externalizer definition model explained in {@link Externalizer}. The first noticeable difference is that this method does not require user classes to be annotated in anyway, so it can be used with classes for which source code is not available or that cannot be modified. The bound between the externalizer and the classes that are marshalled/unmarshalled is set by providing an implementation for {@link #getTypeClasses()} which shouldreturn the list of classes that this externalizer can marshall. Secondly, in order to save the maximum amount of space possible in the payloads generated, this externalizer method requires externalizer implementations to provide a positive identified via {@link #getId()}implementations or via XML/programmatic configuration that identifies the externalizer when unmarshalling a payload. In order for this to work however, this externalizer method requires externalizers to be registered on cache manager creation time via XML or programmatic configuration. On the contrary, externalizers based on {@link Externalizer} and{@link SerializeWith} require no pre-registration whatsoever.Internally, Infinispan uses this advanced externalizer mechanism in order to marshall/unmarshall internal classes. Finally, {@link AbstractExternalizer} provides default implementations forsome of the methods defined in this interface and so it's generally recommended that implementations extend that abstract class instead of implementing {@link AdvancedExternalizer} directly.Even though {@link AdvancedExternalizer} currently extends{@link java.io.Serializable} indirectly, there's no requirement for theadvanced externalizer to be marshalled, because the pre-registration done on startup allows the marshaller to identify the externalizer from the given id. @author Galder Zamarreño @since 5.0

      }


      @Override
      public Object readObject(ObjectInput input) throws IOException, ClassNotFoundException {
         int index = input.read();
         AdvancedExternalizer ext;
         switch (index) {
            case 0:
               ext = idViaConfigObjExt;
               break;
            case 1:
               ext = idViaAnnotationObjExt;
               break;
            case 2:
               ext = idViaBothObjExt;
               break;
            default:
               throw new CacheException(String.format(
                     "Unknown index (%d) for externalizer %s",
                     index, this.getClass().getName()));
         }
         return ext.readObject(input);
      }

   private void loadForeignMarshallables(GlobalConfiguration globalCfg) {
      if (log.isTraceEnabled())
         log.trace("Loading user defined externalizers");
      List<AdvancedExternalizerConfig> configs = globalCfg.getExternalizers();
      for (AdvancedExternalizerConfig config : configs) {
         AdvancedExternalizer ext = config.getAdvancedExternalizer() != null ? config.getAdvancedExternalizer()
               : (AdvancedExternalizer) Util.getInstance(config.getExternalizerClass(), globalCfg.getClassLoader());


         // If no XML or programmatic config, id in annotation is used
         // as long as it's not default one (meaning, user did not set it).
         // If XML or programmatic config in use ignore @Marshalls annotation and use value in config.
         Integer id = ext.getId();
         if (config.getId() == null && id == null)
            throw new ConfigurationException(String.format(
                  "No advanced externalizer identifier set for externalizer %s",
                  ext.getClass().getName()));
         else if (config.getId() != null)
            id = config.getId();


         id = checkForeignIdLimit(id, ext);
         updateExtReadersWritersWithTypes(new ForeignExternalizerAdapter(id, ext), generateForeignReaderIndex(id));

Examples of org.infinispan.marshall.AdvancedExternalizer

Related Classes of org.infinispan.marshall.AdvancedExternalizer