{"id":3370,"date":"2024-03-26T08:29:11","date_gmt":"2024-03-26T12:29:11","guid":{"rendered":"https:\/\/www.yorku.ca\/professor\/drsmith\/?p=3370"},"modified":"2024-03-26T08:29:36","modified_gmt":"2024-03-26T12:29:36","slug":"unit-testing-for-a-project-in-java","status":"publish","type":"post","link":"https:\/\/www.yorku.ca\/professor\/drsmith\/2024\/03\/26\/unit-testing-for-a-project-in-java\/","title":{"rendered":"Unit testing for a project in Java"},"content":{"rendered":"\n

It's important to create test frameworks for your programs. In Java we use the jUnit system to do so. Here is an example of setting up a unit tester to make sure that that a method returns the values it's supposed to.<\/p>\n\n\n\n

First, let's look at the method. I'm using it to convert values that are bounded from 0 to 1023 into values from 0 to 100. I do this before graphing the results. The class is called GraphPeriodicUpdate. The method is called normalizeValue. It takes an integer and returns an integer:<\/p>\n\n\n\n

    \/\/ Conversion of sensor values from 0 to 1023 into 0 to 100;\n<\/span>    static public int normalizeYValue<\/strong>(int originalValue){\n\n        final float MAXVALUE = 1023.0F;\n        final float MINVALUE = 0.0F;\n        final int ERRORVALUE = -1000;\n\n\n        int theReturnValue;\n\n        if((originalValue > MAXVALUE)){\n            theReturnValue = ERRORVALUE;\n        }\n        else if ( (originalValue < MINVALUE) ){\n            theReturnValue = ERRORVALUE;\n        }\n        else{\n            theReturnValue = (int)(100.0*((float)(originalValue)*((1.0)\/(MAXVALUE-MINVALUE))));\n        }\n        return theReturnValue;\n    }<\/code><\/pre>\n\n\n\n
The method is designed to return -1000 if the inputs are outside of the 0 to 1023 boundaries.  Now, my unit tester should ensure that <\/p>\n\n\n\n
  1. the method returns the -1000 error value when faced with inputs that are less than 0 or greater than 1023, and<\/li>
  2. the method only returns values from 0 to 100 if the inputs are 0 to 1023.<\/li><\/ol>\n\n\n\n
    Here's how I can do that:<\/p>\n\n\n\n
    import org.junit.Test;\n\nimport static org.junit.Assert.assertEquals;\nimport static org.junit.Assert.assertTrue;\nimport java.util.Random;\n\npublic class theUnitTest {\n    final int MAXINPUT = 1023;\n    final int MININPUT = 0;\n    final int ERRORVALUE = -1000;\n\n    final int MINRESULT = 0;\n    final int MAXRESULT = 100;\n\n    @Test\n<\/span>    public void testTheGraphNormalizingMethod<\/strong>(){\n\n        \/\/ test to make sure that -1000 is returned for values above 1023 ...\n<\/span>        System.out.println(\"Testing against too positive input...that it returns an error value of \"<\/span> + ERRORVALUE);\n        String theErrorMessage0 = \"Error: wrong value returned for an input above 1023.\"<\/span>;\n        assertEquals<\/span>(theErrorMessage0, ERRORVALUE,GraphPeriodicUpdate.normalizeYValue(MAXINPUT+1));\n        assertEquals<\/span>(theErrorMessage0, ERRORVALUE,GraphPeriodicUpdate.normalizeYValue(MAXINPUT*1000));\n\n        \/\/ ... or below 0.\n<\/span>        System.out.println(\"Testing against too negative input... that it returns an error value of \"<\/span> + ERRORVALUE);\n        String theErrorMessage1 = \"Error: wrong value returned for an input below 0.\"<\/span>;\n        assertEquals<\/span>(theErrorMessage1, ERRORVALUE,GraphPeriodicUpdate.normalizeYValue(MININPUT-1));\n        assertEquals<\/span>(theErrorMessage1, ERRORVALUE,GraphPeriodicUpdate.normalizeYValue((MININPUT-1)*1000));\n\n        \/\/ TESt to see how it behaves for values from 0 to 1023\n        \/\/ if there's a problem, print a message saying so.<\/span>\n        System.out.println(\"Testing against values from \"<\/span> + MININPUT + \" to \"<\/span> + MAXINPUT);\n        int theResult;\n        theResult = GraphPeriodicUpdate.normalizeYValue(MININPUT);\n        String theErrorMessage2 = \"Error: The result shouldn't be below 0\"<\/span>;  \/\/ show this if the test fails.<\/span>\n        assertTrue<\/span>(theErrorMessage2, theResult >= MINRESULT);\n\n        theResult = GraphPeriodicUpdate.normalizeYValue(MAXINPUT+1);\n        String theErrorMessage3 = \"Error: The result shouldn't be above 100<\/span>\"; \/\/ show this if the test fails.<\/span>\n        assertTrue<\/span>(theErrorMessage3, theResult <= MAXRESULT);\n\n        \/\/ Throw at it a hundred random numbers, bounded from min to max values, to see if it fails...\n<\/span>        for (int i = 0; i < 100; i++) {\n                System.out.print(\".<\/span>\");\n                Random randomObject = new Random();\n                int randValue = randomObject.nextInt(MAXINPUT+1);\n                theResult = GraphPeriodicUpdate.normalizeYValue(randValue);\n                String theErrorMessage4 =\"Error: The result is _not_ between 0 and 100\"<\/span>;\n                assertTrue<\/span>(theErrorMessage4, ((theResult <= MAXRESULT)&&(theResult>=MINRESULT)));\n        }\n\n\n    }\n}\n<\/code><\/pre>\n\n\n\n
    I've made this unit tester a lot more verbose than it has to be.  To run the unit test, go into the file that you have defined the unit test class in and press the \"run\" icon:<\/p>\n\n\n\n
    \"running
    Running a unit test. Steps 1 and 2 shown.<\/figcaption><\/figure><\/div>\n\n\n\n\n\n\n\n
    \n\n\n\n
    \"a<\/figure><\/div>\n\n\n\n
    James Andrew Smith is a Professional Engineer and Associate Professor in the Electrical Engineering and Computer Science\u00a0Department<\/a>\u00a0of York University's\u00a0Lassonde School<\/a>, with degrees in Electrical and Mechanical Engineering\u00a0from the University of Alberta and McGill University.\u00a0\u00a0Previously a program director in biomedical engineering, his research background spans robotics, locomotion, human birth and\u00a0engineering\u00a0education. While on sabbatical in 2018-19 with his wife and kids he lived in Strasbourg, France and\u00a0he\u00a0taught at the\u00a0INSA Strasbourg<\/a>\u00a0and\u00a0Hochschule Karlsruhe<\/a>\u00a0and wrote about his\u00a0personal<\/a>\u00a0and\u00a0professional\u00a0<\/a>perspectives<\/a>.\u00a0\u00a0James is a proponent of using social media to advocate for justice, equity, diversity and inclusion as well as evidence-based applications of research\u00a0in the public sphere.\u00a0You can find him on\u00a0Twitter<\/a>. Originally from Qu\u00e9bec City, he now lives in Toronto, Canada.\u00a0\u00a0<\/p>\n","protected":false},"excerpt":{"rendered":"
    It's important to create test frameworks for your programs. In Java we use the jUnit system to do so. Here is an example of setting up a unit tester to make sure that that a method returns the values it's supposed to. First, let's look at the method. I'm using it to convert values that […]<\/p>\n","protected":false},"author":762,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","footnotes":""},"categories":[50],"tags":[671,480],"class_list":["post-3370","post","type-post","status-publish","format-standard","hentry","category-java","tag-junit","tag-unit-test"],"taxonomy_info":{"category":[{"value":50,"label":"java"}],"post_tag":[{"value":671,"label":"junit"},{"value":480,"label":"unit test"}]},"featured_image_src_large":false,"author_info":{"display_name":"drsmith","author_link":"https:\/\/www.yorku.ca\/professor\/drsmith\/author\/drsmith\/"},"comment_info":"","category_info":[{"term_id":50,"name":"java","slug":"java","term_group":0,"term_taxonomy_id":50,"taxonomy":"category","description":"","parent":0,"count":27,"filter":"raw","cat_ID":50,"category_count":27,"category_description":"","cat_name":"java","category_nicename":"java","category_parent":0}],"tag_info":[{"term_id":671,"name":"junit","slug":"junit","term_group":0,"term_taxonomy_id":671,"taxonomy":"post_tag","description":"","parent":0,"count":1,"filter":"raw"},{"term_id":480,"name":"unit test","slug":"unit-test","term_group":0,"term_taxonomy_id":480,"taxonomy":"post_tag","description":"","parent":0,"count":6,"filter":"raw"}],"_links":{"self":[{"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/posts\/3370","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/users\/762"}],"replies":[{"embeddable":true,"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/comments?post=3370"}],"version-history":[{"count":2,"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/posts\/3370\/revisions"}],"predecessor-version":[{"id":3373,"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/posts\/3370\/revisions\/3373"}],"wp:attachment":[{"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/media?parent=3370"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/categories?post=3370"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.yorku.ca\/professor\/drsmith\/wp-json\/wp\/v2\/tags?post=3370"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}