/// <summary> Takes an existing resource, and 'refreshes' it. This generally means that the source of the resource is checked for changes /// according to some cache/check algorithm and if the resource changed, then the resource data is reloaded and re-parsed. /// /// </summary> /// <param name="resource"> resource to refresh /// </param> /// <param name="encoding"> character encoding of the resource to refresh. /// /// </param> /// <throws> ResourceNotFoundException if template not found from current source for this Resource </throws> /// <throws> ParseErrorException if template cannot be parsed due to syntax (or other) Error. </throws> /// <throws> Exception if a problem in parse </throws> protected internal virtual Resource RefreshResource(Resource resource, string encoding) { /* * The resource knows whether it needs to be checked * or not, and the resource's loader can check to * see if the source has been modified. If both * these conditions are true then we must reload * the input stream and parse it to make a new * AST for the resource. */ /* * touch() the resource to reset the counters */ resource.Touch(); if (resource.IsSourceModified) { /* * now check encoding Info. It's possible that the newly declared * encoding is different than the encoding already in the resource * this strikes me as bad... */ if (!string.Equals(resource.Encoding, encoding)) { log.Warn("Declared encoding for template '" + resource.Name + "' is different on reload. Old = '" + resource.Encoding + "' New = '" + encoding); resource.Encoding = encoding; } /* * read how old the resource is _before_ * processing (=>reading) it */ long howOldItWas = resource.ResourceLoader.GetLastModified(resource); string resourceKey = resource.Type + resource.Name; /* * we create a copy to avoid partially overwriting a * template which may be in use in another thread */ Resource newResource = ResourceFactory.getResource(resource.Name, resource.Type); newResource.RuntimeServices = rsvc; newResource.Name = resource.Name; newResource.Encoding = resource.Encoding; newResource.ResourceLoader = resource.ResourceLoader; newResource.ModificationCheckInterval = resource.ResourceLoader.ModificationCheckInterval; newResource.Process(); newResource.LastModified = howOldItWas; resource = newResource; globalCache.Put(resourceKey, newResource); } return(resource); }
/// <summary> Create a new Resource of the specified type. /// /// </summary> /// <param name="resourceName"> The name of the resource to retrieve. /// </param> /// <param name="resourceType"> The type of resource (<code>RESOURCE_TEMPLATE</code>, <code>RESOURCE_CONTENT</code>, etc.). /// </param> /// <returns> new instance of appropriate resource type /// </returns> /// <since> 1.6 /// </since> protected internal virtual Resource CreateResource(string resourceName, int resourceType) { return(ResourceFactory.getResource(resourceName, resourceType)); }
/// <summary> /// Loads a resource from the current set of resource loaders /// </summary> /// <param name="resourceName">The name of the resource to retrieve.</param> /// <param name="resourceType">The type of resource (<code>RESOURCE_TEMPLATE</code>, /// <code>RESOURCE_CONTENT</code>, etc.). /// </param> /// <param name="encoding"> The character encoding to use.</param> /// <returns>Resource with the template parsed and ready. /// @throws ResourceNotFoundException if template not found /// from any available source. /// @throws ParseErrorException if template cannot be parsed due /// to syntax (or other) error. /// @throws Exception if a problem in parse /// </returns> protected internal virtual Resource loadResource(System.String resourceName, int resourceType, System.String encoding) { Resource resource = ResourceFactory.getResource(resourceName, resourceType); resource.RuntimeServices = rsvc; resource.Name = resourceName; resource.Encoding = encoding; /* * Now we have to try to find the appropriate * loader for this resource. We have to cycle through * the list of available resource loaders and see * which one gives us a stream that we can use to * make a resource with. */ long howOldItWas = 0; // Initialize to avoid warnings ResourceLoader resourceLoader = null; for (int i = 0; i < resourceLoaders.Count; i++) { resourceLoader = (ResourceLoader)resourceLoaders[i]; resource.ResourceLoader = resourceLoader; /* * catch the ResourceNotFound exception * as that is ok in our new multi-loader environment */ try { if (resource.Process()) { /* * FIXME (gmj) * moved in here - technically still * a problem - but the resource needs to be * processed before the loader can figure * it out due to to the new * multi-path support - will revisit and fix */ if (logWhenFound) { rsvc.info("ResourceManager : found " + resourceName + " with loader " + resourceLoader.ClassName); } howOldItWas = resourceLoader.getLastModified(resource); break; } } catch (ResourceNotFoundException rnfe) { /* * that's ok - it's possible to fail in * multi-loader environment */ } } /* * Return null if we can't find a resource. */ if (resource.Data == null) { throw new ResourceNotFoundException("Unable to find resource '" + resourceName + "'"); } /* * some final cleanup */ resource.LastModified = howOldItWas; resource.ModificationCheckInterval = resourceLoader.ModificationCheckInterval; resource.Touch(); return(resource); }