All Versions
20
Latest Version
Avg Release Cycle
54 days
Latest Release
379 days ago

Changelog History
Page 1

  • v5.11.2 Changes

    October 08, 2020

    ➕ Added

    • clearing by expectation id
    • 👌 verifying by expectation id

    🔄 Changed

    • 👌 improved reliability and performance around stopping especially when stop is called multiple times for the same instance
    • 👌 improved grouping of logs and stopped TRACE level logs from being grouped which caused inconsistency in the UI

    🛠 Fixed

    • 🛠 fixed recursive loop on stopAsync for ClientAndServer
    • header matching for subsets to ensure notted header keys don't exist
  • v5.11.1 Changes

    July 22, 2020

    ➕ Added

    • 🖨 port is now printed at start of each log line
    • 🌲 shutdown log message specifying port
    • ⚡️ UI updated prior to stopping MockServer to ensure all pending log messages are sent over UI web socket
    • ➕ added listener for expectation modifications that can be used with ExpectationInitializer for custom expectation persistence

    🔄 Changed

    • 🐎 performance improvements of expectation sorting and comparisons
    • ⬇️ reduced creation of objects at WARN log level
    • ensured all threads are daemon threads (except port binding thread)
    • 🐎 simplified and improve performance of matching for headers, query string parameters, path parameters, cookies and body parameters
    • 💻 only mark log events as deleted for log level of TRACE, DEBUG, or INFO so log can be view in UI
    • 👌 improved performance of handling large OpenAPI specifications
    • 👌 improved error message format for errors when loading OpenAPI specifications
    • 🔄 changed name of optionalString static factory method to optional to improve consistency with not

    🛠 Fixed

    • 🛠 fixed field name error when serializing ParameterBody
    • 🌲 error when log level DEBUG cleared log events were returned from the API
  • v5.11.0 Changes

    July 08, 2020

    ➕ Added

    • ➕ added basic support to proxy binary requests that are not HTTP
    • 🌲 dynamic maximum log events and maximum expectations based on available memory
    • ➕ added ability to switch between BouncyCastle and vanillar JDK for key and certificate generation
    • ➕ added support for TLS over SOCKS4 or SOCKS5
    • request matching and expectations using OpenAPI or Swagger specification
    • create expectation using OpenAPI or Swagger specification with automatic example responses
    • verifications of requests or request sequences using OpenAPI or Swagger specification
    • 🔊 clear log, clear expectations, retrieve logs and retrieve requests using OpenAPI or Swagger specification
    • json schema matchers for method, path, headers, query string parameters and cookies
    • path variables matched by nottable string, regex or json schema (as per query string parameters)
    • 👌 support for optional query parameters, header and cookies
    • 👌 support for nullable keyword in JSON Schemas (part of Open API specification not JSON Schema specification)
    • matching xml bodies against JSON Schema matchers
    • matching parameter bodies against JSON Schema matchers
    • 👌 support to match path parameters, query parameters and header either by sub set or by matching key
    • 💻 grouping of log events in UI to simplify analysis of expectation matches / non matches for a request
    • ➕ added extra log messages to indicate progress for large json expectation initializers
    • ➕ added log messages for invalid control plane request to make control plane errors clearer in the UI
    • ➕ added support for easily mapping jar and config into the docker container
    • ➕ added support for easily mapping jar and config into the helm chart

    🔄 Changed

    • ⬇️ reduced time range of CA certificates to increase likelihood they will be accepted by strict systems (i.e. VMWare vCenter Server)
    • 👌 improved error message when exception loading or reading certificates or keys (i.e. file not found)
    • ⚡️ certificate and private key are saved to directoryToSaveDynamicSSLCertificate when preventCertificateDynamicUpdate is enabled
    • ⚡️ returns created expectations from /mockserver/expectation so that it is possible to view the id for new (or updated) expectations
    • ➕ added ability to inherit @MockServerSettings for Junit5 tests
    • 🔒 switched to distroless container base for security and size
    • ➕ added explicit gc suggestion after reset and clear
    • ⬆️ upgraded docker container to Java 11 to ensure JVM honours container memory constraints (i.e. inside kubernetes)
    • 👌 improved parsing of invalid content-type header parameters by handling error gracefully and outputting a clear error message
    • 👌 improved performance through multiple minor tweaks around handling of expectations
    • ➕ added version to log output to improve resolution of github issues with logs attached
    • 👌 improved logic around proxies to make HTTP CONNECT, SOCKS4 and SOCKS5 more reliable and faster
    • ⬇️ reduced object creation (and therefore GCs) for log especially during request matching
    • 🔊 print logs timestamp with milliseconds
    • ⬇️ reduced expiry of certification to one year to avoid errors from modern systems that don't like long lived certificates (such as Chrome or VMWare)
    • 0️⃣ defaulted charset for XML and JSON to UTF8 as per rfc3470 and rfc8259
    • 🔖 version matching logic for client now only matches on major and minor version and not bug fix version
    • 👌 improved handling of body matching for control plane to clearly separate control plane and data plan matching
    • 💻 simplified and improved stability for UI by moving all data processing into back-end and other simplifications

    🛠 Fixed

    • 🛠 fixed but with environment variable configuration for long, integer and integer list values
    • ✂ removed call to ReflectionToStringBuilder.setDefaultStyle to avoid impacting toString globally for JVM
    • 🛠 fixed destination port and ip in Socks5CommandResponse which prevented SOCKS5 proxied connections
    • 🛠 fixed Subject Alternative Names with wildcards or other valid DNS name formats not supported by certain versions of the JDK (<= 1.8)
    • 🛠 fixed json body responses by returning blank or null fields, objects and arrays
    • 🛠 fixed generics for withCallbackClass to allow ExpectationResponseCallback to be specified as a Class (not only a string)
  • v5.10.0 Changes

    March 24, 2020

    ➕ Added

    • 🌐 closure / object callbacks uses local method invocation (instead of Web Socket) when both the client in same JVM (i.e. ClientAndServer, JUnit Rule, etc)
    • 👌 support to specify a fixed TLS X509 Certificate and Private Key for inbound TLS connections (HTTPS or SOCKS)
    • ability to prioritise expectations such that the matching happens according to the specified priority (highest first) then creation order
    • ⚡️ ability to create or update (if id matches) expectations from the client using upsert method
    • ability to return chunked responses where each chunk is a specific size by using response connection options
    • 👌 support for XmlUnit placeholders https://github.com/xmlunit/user-guide/wiki/Placeholders
    • ➕ added ability to control (via configuration) whether matches fail fast or show all mismatching fields
    • 🔧 configuration to disable automatically attempted proxying of request that don't match an expectation and look like they should be proxied

    🔄 Changed

    • 👌 improved X509 certificates by adding Subject Key Identifier and Authority Key Identifier
    • stopped delay being applied twice on response actions (#721)
    • 👌 improve support for clients making initial SOCKS or HTTP CONNECT requests over TLS
    • 🚚 replaced JSONAssert with JsonUnit to improve JSON matching and remove problematic transitive dependencies
    • ➕ added more detail of cause of match failure

    🛠 Fixed

    • 🛠 fixed null point for expectation initialiser with file watcher in working directory specified with relative path
    • 🛠 fixed error resulting in enum not found exception for log events
    • 🛠 fixed error with parsing of json arrays for expectation responses with json body as json object not escaped string
    • 🛠 fixed meaning of disableSystemOut property so that only system out is disabled not all logging
    • 🛠 fixed key store type in key store factory to avoid issue with the JVM changing the defaults
  • v5.9.0 Changes

    February 01, 2020

    ➕ Added

    • ➕ added stopAsync method to ClientAndServer to allow stop without waiting
    • 🚚 log events for UPDATED_EXPECTATION and REMOVED_EXPECTATION
    • ⚡️ ability to update existing expectation by id
    • hot re-loading of expectation initialiser file
    • ➕ addition configuration for web socket client event loop size
    • ➕ addition configuration for action handler thread pool size
    • 🔦 exposed request raw bytes to object callbacks (allows forwarded requests body parsing that is inconsistent with Content-Type header)
    • ➕ added support to delay socket closure using connection options
    • ➕ added support to control trusted certificate authorities (trust store) for proxied & forwarded requests
    • ➕ added support for two-way TLS (mTLS), also called client authentication
    • 👍 now sends TLS X509 certificate from proxy (i.e. support forward client authentication / mTLS)
    • ➕ added ability to dynamically create local unique Certificate Authority (CA) X.509 and Private Key to improve securiy of clients trusting the CA

    🔄 Changed

    • 🐎 performance improvements for header and cookie handling
    • 👌 improved JSON validation errors by adding link to OpenAPI Specification
    • ✂ removed duplicate packages between modules to prepare for java modules
    • 🔧 caught Jackson configuration exception to improve resilience with other Jackson versions in classpath
    • 🏗 moved Junit4 to separate module to reduce size of jar-with-dependencies, simplify code and increase build speed
    • enabled case insensitive matching for regex matches
    • 👌 improved documentation (i.e. on website)
    • switched from Bouncy Castle to JDK for certificate and private key generation

    🛠 Fixed

    • 🛠 fixed error where ClientAndServer does fully wait for client to stop
    • 🛠 fixed ability to specific a log level of OFF
    • 🛠 fixed bug with keystore type configuration not being used in all places
    • ➕ added file locking and jvm locking for expectation persistence file to avoid file corruption
    • 🛠 fixed verification incorrectly matching verifier non-empty bodies against empty request bodies
    • stopped response callbacks for proxied requests blocking threads
    • 🛠 fixed bug that caused JSON bodies in specified expectations as raw JSON to ignore empty arrays and empty strings

    🔒 Security

    • ⚡️ updated tomcat (used in integration tests) to version without vulnerabilities
  • v5.8.1 Changes

    December 23, 2019

    ➕ Added

    • 🔄 changelog
    • ➕ added configuration for all CORS headers
    • ➕ added support for forward proxy authentication (via configuration)
    • ➕ added support for overriding forward responses by class or closure
    • ⚡️ requests sent to MockServerClient can be updated / enhanced i.e. to support proxies
    • 🛠 dynamic creation of a unique (i.e. local) Certificate Authority X509 Certificate and Private Key instead of using the fixed Certificate Authority X509 Certificate and Private Key in the git repo.
    • 🔧 configuration to require mTLS (also called client authentication or two-way TLS) for all TLS connections / HTTPS requests to MockServer
    • 🔧 configuration of trust store and client X.509 used during forwarded and proxied requests to endpoints requiring mTLS
    • 📚 extended TLS documentation significantly

    🔄 Changed

    • ⬇️ reduced default number of fail handles used by nio event loop
    • 👌 improved performance and scalability of logging ring buffer
    • 👌 improved performance of json serialisation
    • 🗄 deprecated isRunning and replaced with hasStopped and hasStarted to make behaviour more explicit and faster
    • 👌 improved, simplified and unified handling of Content-Type for bodies
    • ✂ remove closure callback clients and connections for expectation that no longer exist
    • ensure WebSockets for closure callback auto re-connect for unreliable networks
    • 💻 simplified XML and JSON of bodies in the log and UI
    • 👌 improved logging for CORS
    • ➕ added support for TLS with closure / WebSocket callbacks
    • simplified handling of TLS and HTTP CONNECT (which is always TLS)
    • 👌 improved JSON format for expectation to support objects instead of escaped strings

    🛠 Fixed

    • 🛠 fixed reading logLevel from system property or environment variable
    • 🖨 ensure all errors are printed to console
    • ✂ removed TLSv1.3 to avoid any issues with JVM version that do not support TLSv1.3
    • 🖐 handle proxying requests without Content-Length header
    • ➕ added support for JSON array for raw JSON in requests or responses body

    🔒 Security

    • ⚡️ updated jetty (used in code examples) to version without vulnerabilities
  • v5.8.0 Changes

    December 01, 2019

    ➕ Added

    • ➕ added support for configuration via environment variables
    • ➕ added support for overriding responses which an forward overridden request
    • ➕ added persistence of expectations to file (as json)

    🔄 Changed

    • 🤡 ensured all Netty threads are marked as daemon to ensure MockServer does not prevent / delay JVM shutdown
    • 👌 improved docker-compose example
    • 👌 improved helm document & example to show how to provide configuration file or expectation initialiser
    • 👌 improved performance and throttled load for UI

    🛠 Fixed

    • WARN and ERROR is logged even if logLevel not yet initialised
    • ensured exceptions thrown in Main method are always logged
    • separated control plane and data plane matching to avoid reverse regex matches and other similar strange behaviour
    • 🛠 fixed handling of multiple parameters in Content-Type header
    • ⚡️ autodetect WS or WSS for UI update WebSocket depending on HTTP or HTTPS
    • 🖨 stopped usage being printed multiple time under certain error scenarios

    ✂ Removed

    • ✂ removed re-entrant WebSocket prevention by creating WebSocket client per expectation to improve resilience
  • v5.7.2 Changes

    November 16, 2019

    ➕ Added

    • ➕ added setting to control maximum size of event log

    🔄 Changed

    • 🐎 performance enhancements
    • 👌 improved matcher failure log messages to output detail at DEBUG level
    • 🔧 made log level configuration more resilient
    • 👍 allowed exceptions to be thrown from all types of callback methods

    🛠 Fixed

    • 🛠 fixed duplicate logging or request when optimistic proxying
    • ➕ added missing exception on bind error
    • ensured client event bus is not static so it not shared across multiple client instances except were server port is identical
  • v5.7.1 Changes

    November 09, 2019

    ➕ Added

    • ➕ added disruptor ring buffer in front of log to improve performance
    • ➕ added configuration to ensure MockServer certificate is not updated once created

    🔄 Changed

    • 👌 improved performance with request matcher fast failure
    • ♻️ refactored CPU or memory hot spots
    • 🌲 switched logging to simpler more resilient approach without external dependencies

    🛠 Fixed

    • 🛠 fixed log levels to support disabling the log completely without impacting verifications
    • 🌲 ensured clear, reset and verify guarantee all pending log events are completed
    • 🤡 ensured all thread pools (i.e. added disruptor, etc) are stopped with stopping MockServer or Servlets
    • respond with not found response (instead of hanging) when failure during template rendering
  • v5.7.0 Changes

    November 01, 2019

    ➕ Added

    • ➕ added support for retrieving requests and associated responses from log
    • ➕ added support for access-control-request-headers with CORS

    🔄 Changed

    • ⚡️ updated to Java 8
    • 📜 made Jackson more relaxed when parsing JSON already validated by JSON Schema
    • 👌 improved resilience of request and response parsing, such as when Content-Type is blank string
    • 👌 improved proxy loop prevention to only break loops within a single instance of MockServer
    • increased length of TLS keys to RSA 2048
    • 0️⃣ increased default request log size and maximum number of expectation

    🛠 Fixed

    • ➕ added global thread-safety to javascript templates for local variables defined without keyword var