There are times when it can be convenient for static files (such as text files, configuration files, images, etc.) to be packaged with a library. In the Java world, these types of files are referred to as resources and the libraries are known as jar files. The simplest way to ensure that a jar file can reference the resources it needs is to physically bundle them into the jar file itself. <\/p>\n\n\n\n
The question then becomes: How can the code within a jar file reference a resource file?<\/p>\n\n\n\n
It’s actually pretty simple, as illustrated in Listing 1<\/strong>. Java provides several ways to read a resource file, of which the simplest is to use the getResourceAsStream method provided by Java’s Class class. This method accepts the name of the resource as a parameter and returns an InputStream reference for the resource (or null if it cannot find the resource). Content can be easily read from the file using a BufferedReader object.<\/p>\n\n\n\n The name provided to the getResourceAsStream method can be an absolute or relative pathname. If relative, it is interpreted relative to the package path. For example:<\/p>\n\n\n\n The leading “\/” causes the getResourceAsStream method to look for the resource at the top level within the jar file. With the relative pathname, the file is expected to be located at the same level within the jar file as the class itself.<\/p>\n\n\n\n Note that the ClassLoader class also has a getResourceAsStream method which can be used to read resources, but it only supports absolute paths. In general, the Class version of the method is more frequently used.<\/p>\n\n\n\n Listing 1 – Displaying A Resource File<\/strong><\/p>\n\n\n\n Well, that was a great way to read, and display, a resource file, but it would be nice to actually use the properties defined in the myapp.properties file. Listing 2<\/strong> shows how the properties can easily be processed from a configuration file packaged as a resource. This technique can be a great way to set default parameters for a class.<\/p>\n\n\n\n Listing 2 – Reading Properties From a Resource File<\/strong><\/p>\n\n\n\n To read the properties from the file, create an instance of the Properties class, then call the object’s Load method with an InputStream that references the resource, as shown below:<\/p>\n\n\n\n To get a value for an individual property:<\/p>\n\n\n\n In Java, static resources can safely and effectively be bundled with compiled classes within easily distributable jar files. Storing such resources within the jar files ensures that the resources will be available to classes when needed, i.e. \u2014 it is very difficult for the resources to become separated from the code when they are bundled with it. In turn, resources can be easily referenced by Java code, so there’s no penalty, in terms of access cost, in bundling resources within jar files.<\/p>\n","protected":false},"excerpt":{"rendered":" There are times when it can be convenient for static files (such as text files, configuration files, images,<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7],"tags":[109,110],"class_list":["post-981","post","type-post","status-publish","format-standard","hentry","category-software","tag-jar","tag-java"],"_links":{"self":[{"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=\/wp\/v2\/posts\/981","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=981"}],"version-history":[{"count":0,"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=\/wp\/v2\/posts\/981\/revisions"}],"wp:attachment":[{"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=981"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=981"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/staging.keenertech.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=981"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Type<\/td> Path<\/td> Expected Location<\/td><\/tr> <\/td> Absolute<\/strong><\/td> \/myapp.properties<\/td> \/myapp.properties<\/td><\/tr> <\/td> Relative<\/strong><\/td> myapp.properties<\/td> \/com\/keenertech\/experiment\/myapp.properties<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n package com.keenertech.experiment;\n\nimport java.io.*;\nimport java.util.*;\n\npublic class ResourceExperiment\n{ \n private void displayResource(String strName)\n {\n try\n {\n BufferedReader objBin = new BufferedReader(new InputStreamReader(\n this.getClass().getResourceAsStream(strName)));\n if (objBin != null)\n {\n String strLine = null;\n while ((strLine = objBin.readLine()) != null)\n {\n System.out.println(strLine);\n }\n objBin.close();\n }\n else\n {\n System.out.println(\"Error: Unable to retrieve InputStream\");\n }\n }\n catch (Exception e)\n {\n System.out.println(e);\n }\n } \/\/ End Method\n\n public static void main(String[] args)\n {\n ResourceExperiment objRes = new ResourceExperiment();\n objRes.displayResource(\"\/myapp.properties\");\n } \/\/ End Method\n\n } \/\/ End Class\n<\/pre>\n\n\n\nReading a Properties File<\/h3>\n\n\n\n
private void readPropertyFile(String fileName)\n {\n try\n {\n Properties objProperties = new Properties();\n objProperties.load(this.getClass().getResourceAsStream(fileName));\n\n strHostName = objProperties.getProperty(\"hostname\");\n \/\/ .....more properties as needed.....\n }\n catch (Exception e)\n {\n System.out.println(\"ERROR: Could not read properties file\\n\");\n e.printStackTrace();\n }\n } \/\/ End Method\n<\/pre>\n\n\n\n objProperties.load(this.getClass().getResourceAsStream(fileName));<\/code><\/pre>\n\n\n\n strHostName = objProperties.getProperty(\"hostname\");<\/code><\/pre>\n\n\n\nConclusion<\/h3>\n\n\n\n