{"id":2756,"date":"2005-10-05T13:04:49","date_gmt":"2005-10-05T11:04:49","guid":{"rendered":"http:\/\/blog.jteam.nl\/?p=2756"},"modified":"2005-10-05T13:04:49","modified_gmt":"2005-10-05T11:04:49","slug":"easymock2-in-a-nutshell","status":"publish","type":"post","link":"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/","title":{"rendered":"EasyMock2 in a Nutshell"},"content":{"rendered":"

The essential tool for unit testing, EasyMock<\/a>, has come to a new level. This blog entry introduces the new EasyMock2 release.
\nWhile it is still in pre-release stage, I do recommend using EasyMock2 for all your Java 5 projects.<\/p>\n

To quote Tammo Freese (Project Founder) from the EasyMock project:<\/p>\n

\n\u2018I plan no modifications other than bug fixes from this point.\u2019\n<\/p><\/blockquote>\n

<\/p>\n

What\u2019s new<\/h3>\n
    \n
  1. No more need for MockControl objects<\/li>\n
  2. Build in argument matchers for most common argument matching (a lot less nuisance of having to write your own ArgumentMatcher<\/code>)<\/li>\n<\/ol>\n

    Step-by-step example<\/h3>\n

    Let\u2019s look at a step-by-step example of using EasyMock2:<\/p>\n

      \n
    1. \nPut the following line in your imports:<\/p>\n

      import static<\/b> org.easymock.EasyMock.*;<\/code><\/p>\n

      Note the static import, this imports all static members (methods in this case) from the EasyMock class.
      \nMore on static imports here:       http:\/\/java.sun.com\/j2se\/1.5.0\/docs\/guide\/language\/static-import.html<\/a>.\n<\/li>\n

    2. \nCreate a mock object using the following line (probably in your setup() method):<\/p>\n

      myManager = createMock(MyManager.class);<\/code><\/p>\n

      Note 1. It is still only possible to mock interfaces and NOT classes. However, using EasyMock Class Extension<\/a> it is possible to mock classes.
      \nNote 2. The createMock()<\/code> method is a static method on the EasyMock class. It is still possible to use the methods createStrictMock()<\/code> and createNiceMock()<\/code> to respectively create a mock which also verifies the order in which the methods are called and a mock that allows all method calls and returns appropriate empty values by default.
      \nImportant: do not forget to set the mocked object on the class under testing.\n<\/li>\n

    3. \nSpecify behavior for the mock object. This example assumes we expect the method isDebug() to be called on our manager six times and returning false on each occasion:<\/p>\n

      expect(myManager.isDebug()).andReturn(false).times(6);<\/code><\/p>\n

      Note 1. Apart from andReturn()<\/code>, you could also use andThrow()<\/code> to throw an exception. You can also use andStubReturn()<\/code> and andStubThrow()<\/code> to specify default behavior.
      \nNote2. In EasyMock2 it is easy to specify the number of times you expect the method to be called (in the example the times(6)<\/code> call). Next to the times(int)<\/code> method, there are a number of other convenience methods:<\/p>\n

      times(int count)<\/code>
      \ntimes(int min, int max)<\/code> – expect between min and max calls
      \natLeastOnce()<\/code> – expect the method to be called at least once
      \nanyTimes()<\/code> – expect an unrestricted number of calls\n<\/li>\n

    4. \nSet the mock in the replay state and verify after testing the class under test, similar to calling replay and verify on the MockControl object in the previous EasyMock version:<\/p>\n

      replay<\/i>(myManager);<\/code>
      \nclassUnderTest.someMethod();<\/code>
      \nverify<\/i>(myManager);<\/code>\n<\/li>\n<\/ol>\n

      Best new feature<\/h3>\n

      Ok, so far so good, but I left out the best new feature (in my opinion).<\/p>\n

      Remember a method being called with unknown or different arguments on each call. You had to write your own argument matcher. No more\u2026\u2026
      \nNow, for example you can do the following:<\/p>\n

      myManager.someMethod(eq(\u201canArgument\u201d),isA(Method.class),notNull());<\/code><\/p>\n

      Note 1. The first argument is equivalent to just calling:
      \nmyManager.someMethod(\"anArgument\"<\/code>…
      \nNote 2. The second argument specifies that it expects an instance of the Method class
      \nNote 3. The last argument is expected to not be null<\/code>
      \nNote 4. Either all arguments of a call have to be given by specifying argument matchers, or none<\/p>\n

      The list of build in argument matchers is pretty extensive, but ofcourse it is still possible to write your own ArgumentMatcher<\/code>
      \nBelow is a list of all build in argument matchers (copied from the EasyMock2 documentation).<\/p>\n

      \neq(X value)<\/code>
      \nMatches if the actual value is equals the expected value. Available for all primitive types and for objects.<\/p>\n

      anyBoolean()<\/code>, anyByte()<\/code>, anyChar()<\/code>, anyDouble()<\/code>, anyFloat()<\/code>, anyInt()<\/code>, anyLong()<\/code>, anyObject()<\/code>, anyShort()<\/code>
      \nMatches any value. Available for all primitive types and for objects.<\/p>\n

      eq(X value, X delta)<\/code>
      \nMatches if the actual value is equal to the given value allowing the given delta. Available for float<\/code> and
      \ndouble<\/code>.<\/p>\n

      aryEq(X value)<\/code>
      \nMatches if the actual value is equal to the given value according to Arrays.equals()<\/code>. Available for primitive and object arrays.<\/p>\n

      isNull()<\/code>
      \nMatches if the actual value is null<\/code>. Available for objects.<\/p>\n

      notNull()<\/code>
      \nMatches if the actual value is not null<\/code>. Available for objects.<\/p>\n

      same(X value)<\/code>
      \nMatches if the actual value is the same as the given value. Available for objects.<\/p>\n

      isA(Class clazz)<\/code>
      \nMatches if the actual value is an instance of the given class, or if it is in instance of a class that extends or implements the given class. Available for objects.<\/p>\n

      lt(X value)<\/code>, leq(X value)<\/code>, geq(X value)<\/code>, gt(X value)<\/code>
      \nMatches if the actual value is less than\/less or equal\/greater or equal\/greater than the given value. Available for all numeric primitive types.\n<\/p><\/blockquote>\n

      Hope this blog entry will help you improve your unit testing! It has definitely reduced the amount of mock code in the tests that I have refactored to EasyMock2. Hopefully the final version will be released very soon.<\/p>\n","protected":false},"excerpt":{"rendered":"

      The essential tool for unit testing, EasyMock, has come to a new level. This blog entry introduces the new EasyMock2 release. While it is still in pre-release stage, I do recommend using EasyMock2 for all your Java 5 projects. To quote Tammo Freese (Project Founder) from the EasyMock project: \u2018I plan no modifications other than […]<\/p>\n","protected":false},"author":22,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","footnotes":""},"categories":[10],"tags":[119,11,120,121],"class_list":["post-2756","post","type-post","status-publish","format-standard","hentry","category-development","tag-easymock","tag-java","tag-testing","tag-testing-tools"],"acf":[],"yoast_head":"\nEasyMock2 in a Nutshell - Trifork Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"EasyMock2 in a Nutshell - Trifork Blog\" \/>\n<meta property=\"og:description\" content=\"The essential tool for unit testing, EasyMock, has come to a new level. This blog entry introduces the new EasyMock2 release. While it is still in pre-release stage, I do recommend using EasyMock2 for all your Java 5 projects. To quote Tammo Freese (Project Founder) from the EasyMock project: \u2018I plan no modifications other than […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/\" \/>\n<meta property=\"og:site_name\" content=\"Trifork Blog\" \/>\n<meta property=\"article:published_time\" content=\"2005-10-05T11:04:49+00:00\" \/>\n<meta name=\"author\" content=\"Bram Smeets\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Bram Smeets\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/\",\"url\":\"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/\",\"name\":\"EasyMock2 in a Nutshell - Trifork Blog\",\"isPartOf\":{\"@id\":\"https:\/\/trifork.nl\/blog\/#website\"},\"datePublished\":\"2005-10-05T11:04:49+00:00\",\"author\":{\"@id\":\"https:\/\/trifork.nl\/blog\/#\/schema\/person\/a4c4fd4f94ab0974a08b2ee382fd3841\"},\"breadcrumb\":{\"@id\":\"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/trifork.nl\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"EasyMock2 in a Nutshell\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/trifork.nl\/blog\/#website\",\"url\":\"https:\/\/trifork.nl\/blog\/\",\"name\":\"Trifork Blog\",\"description\":\"Keep updated on the technical solutions Trifork is working on!\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/trifork.nl\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/trifork.nl\/blog\/#\/schema\/person\/a4c4fd4f94ab0974a08b2ee382fd3841\",\"name\":\"Bram Smeets\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/trifork.nl\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/8281f54c4a011d16a05764251cf11d26?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/8281f54c4a011d16a05764251cf11d26?s=96&d=mm&r=g\",\"caption\":\"Bram Smeets\"},\"url\":\"https:\/\/trifork.nl\/blog\/author\/bram\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"EasyMock2 in a Nutshell - Trifork Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/","og_locale":"en_US","og_type":"article","og_title":"EasyMock2 in a Nutshell - Trifork Blog","og_description":"The essential tool for unit testing, EasyMock, has come to a new level. This blog entry introduces the new EasyMock2 release. While it is still in pre-release stage, I do recommend using EasyMock2 for all your Java 5 projects. To quote Tammo Freese (Project Founder) from the EasyMock project: \u2018I plan no modifications other than […]","og_url":"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/","og_site_name":"Trifork Blog","article_published_time":"2005-10-05T11:04:49+00:00","author":"Bram Smeets","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Bram Smeets","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/","url":"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/","name":"EasyMock2 in a Nutshell - Trifork Blog","isPartOf":{"@id":"https:\/\/trifork.nl\/blog\/#website"},"datePublished":"2005-10-05T11:04:49+00:00","author":{"@id":"https:\/\/trifork.nl\/blog\/#\/schema\/person\/a4c4fd4f94ab0974a08b2ee382fd3841"},"breadcrumb":{"@id":"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/trifork.nl\/blog\/easymock2-in-a-nutshell\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/trifork.nl\/blog\/"},{"@type":"ListItem","position":2,"name":"EasyMock2 in a Nutshell"}]},{"@type":"WebSite","@id":"https:\/\/trifork.nl\/blog\/#website","url":"https:\/\/trifork.nl\/blog\/","name":"Trifork Blog","description":"Keep updated on the technical solutions Trifork is working on!","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/trifork.nl\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/trifork.nl\/blog\/#\/schema\/person\/a4c4fd4f94ab0974a08b2ee382fd3841","name":"Bram Smeets","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/trifork.nl\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/8281f54c4a011d16a05764251cf11d26?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/8281f54c4a011d16a05764251cf11d26?s=96&d=mm&r=g","caption":"Bram Smeets"},"url":"https:\/\/trifork.nl\/blog\/author\/bram\/"}]}},"_links":{"self":[{"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/posts\/2756","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/comments?post=2756"}],"version-history":[{"count":0,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/posts\/2756\/revisions"}],"wp:attachment":[{"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/media?parent=2756"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/categories?post=2756"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/trifork.nl\/blog\/wp-json\/wp\/v2\/tags?post=2756"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}