/*@jsxRuntime automatic @jsxImportSource react*/ const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; function _createMdxContent(props) { const _components = Object.assign({ p: "p", a: "a", em: "em", code: "code", pre: "pre", h2: "h2", h3: "h3", strong: "strong" }, _provideComponents(), props.components), {LS, UsedTerms, CodeTabs, CodeTabsBlock, SourceCodeTabs, SourceClass, Term} = _components; if (!CodeTabs) _missingMdxReference("CodeTabs", true); if (!CodeTabsBlock) _missingMdxReference("CodeTabsBlock", true); if (!LS) _missingMdxReference("LS", true); if (!SourceClass) _missingMdxReference("SourceClass", true); if (!SourceCodeTabs) _missingMdxReference("SourceCodeTabs", true); if (!Term) _missingMdxReference("Term", true); if (!UsedTerms) _missingMdxReference("UsedTerms", true); return _jsxs(_Fragment, { children: [_jsx(LS, { to: "e", children: _jsx(_components.p, { children: "The evitaQL language selection for this article makes no sense." }) }), "\n", _jsx(LS, { to: "c", children: _jsxs(_components.p, { children: ["Unfortunately, we don't have a support written for a C# client, yet. Want to\n", _jsx(_components.a, { href: "https://github.com/FgForrest/evitaDB", children: "contribute" }), "?"] }) }), "\n", _jsxs(LS, { to: "j,g,r", children: [_jsxs(UsedTerms, { children: [_jsx("h4", { children: "Terms used in this document" }), _jsxs("dl", { children: [_jsx("dt", { children: "autowiring" }), _jsx("dd", { children: _jsxs(_components.p, { children: ["Autowiring is the process of placing an instance of a bean into the specified argument of the method. This\nmechanism is known as the ", _jsx(_components.a, { href: "https://en.wikipedia.org/wiki/Dependency_injection", children: "dependency injection pattern" }), "\nand allows the ", _jsx(_components.em, { children: "framework" }), " to resolve the correct instance for the argument of a given name and type, and\nautomatically provide it to the application code. This process allows the application logic to be decoupled\nfrom the integration logic and greatly simplifies it."] }) })] })] }), _jsxs(_components.p, { children: ["To take advantage of our support for application testing with evitaDB, you first need to import the ", _jsx(_components.code, { children: "evita_test_support" }), "\nartifact into your project:"] }), _jsxs(CodeTabs, { children: [_jsx(CodeTabsBlock, { children: _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-Maven", children: "\n io.evitadb\n evita_test_support\n 2024.2.2\n test\n\n" }) }) }), _jsx(CodeTabsBlock, { children: _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-Gradle", children: "implementation 'io.evitadb:evita_test_support:2024.2.2'\n" }) }) })] }), _jsxs(_components.p, { children: ["Our testing support requires and is written for the ", _jsx(_components.a, { href: "https://junit.org/junit5/docs/current/user-guide/", children: "JUnit 5" }), " test\nframework."] }), _jsx(_components.h2, { id: "junit-test-class", children: "JUnit test class" }), _jsx(_components.p, { children: "Let's first take a look at what a commonly written automated test that uses data in evitaDB would look like:" }), _jsx(SourceCodeTabs, { local: true, children: _jsx(_components.p, { children: _jsx(_components.a, { href: "/documentation/user/en/use/api/example/test-with-empty-dataset-example.java", children: "JUnit5 test example" }) }) }), _jsxs(_components.p, { children: ["That's quite a lot of work. Therefore, we provide better support for evitaDB server initialization using\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DbInstanceParameterResolver.java" }), ",\nwhich can be integrated into your test via JUnit 5 annotation ", _jsx(_components.code, { children: "@ExtendWith(DbInstanceParameterResolver.class)" }), ":"] }), _jsx(SourceCodeTabs, { local: true, children: _jsx(_components.p, { children: _jsx(_components.a, { href: "/documentation/user/en/use/api/example/test-with-empty-dataset-alternative.java", children: "Alternative test example" }) }) }), _jsxs(_components.p, { children: ["This example class will create ", _jsx(_components.em, { children: "an anonymous instance" }), " of an empty embedded evitaDB server and destroy it immediately\nafter the test has finished. If you want to name the evitaDB server instance and use it in multiple tests (and possibly\nwith some initial data fixture), you need to define a new initialization function in your test and use two new\nannotations ", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/annotation/DataSet.java" }), "\nand ", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/annotation/UseDataSet.java" }), ":"] }), _jsx(SourceCodeTabs, { local: true, children: _jsx(_components.p, { children: _jsx(_components.a, { href: "/documentation/user/en/use/api/example/test-with-prefilled-dataset.java", children: "Named and filled dataset test example" }) }) }), _jsxs(_components.p, { children: ["As you can see in the example, the ", _jsx(_components.code, { children: "setUpData" }), " method declares that it will initialize a data set named\n", _jsx(_components.code, { children: "dataSetWithAFewData" }), ", creates a new collection ", _jsx(_components.code, { children: "Brand" }), " with a single entity containing the attribute ", _jsx(_components.code, { children: "name" }), " with\nthe value ", _jsx(_components.code, { children: "Siemens" }), ". The ", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DbInstanceParameterResolver.java" }), "\nautomatically ", _jsx(Term, { name: "autowiring", children: "autowires" }), " a\n", _jsx(SourceClass, { children: "evita_api/src/main/java/io/evitadb/api/EvitaSessionContract.java" }), "\nobject that allows communication with the evitaDB instance (see ", _jsx(_components.a, { href: "#annotations-reference", children: "reference" }), " for more options\nof the ", _jsx(_components.code, { children: "@DataSet" }), " annotation)."] }), _jsxs(_components.p, { children: ["In addition, there is a test method ", _jsx(_components.code, { children: "exampleTestCaseWithAssertions" }), ", which declares that it uses the dataset named\n", _jsx(_components.code, { children: "dataSetWithAFewData" }), " by using the ", _jsx(_components.code, { children: "@UseDataSet" }), " annotation. The same\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DbInstanceParameterResolver.java" }), "\nautomatically ", _jsx(Term, { name: "autowiring", children: "autowires" }), " a reference to another evitaDB session object which is used in\nthe test method implementation to query and assert the results of the data in the database."] }), _jsx(_components.h3, { id: "test-web-apis", children: "Test web APIs" })] }), "\n", _jsxs(LS, { to: "j", children: [_jsx(_components.p, { children: "A similar approach is possible with the evitaDB Java Client through gRPC API. When setting up your dataset, simply declare that you also\nwant to initialize the gRPC web server and open required set of web APIs:" }), _jsx(SourceCodeTabs, { local: true, children: _jsx(_components.p, { children: _jsx(_components.a, { href: "/documentation/user/en/use/api/example/test-with-prefilled-dataset-and-grpc-web-api.java", children: "Web API test example" }) }) }), _jsxs(_components.p, { children: ["The example is identical to the previous one with the only significant difference - instead of communicating\nwith the embedded evitaDB server via direct method calls, it uses\n", _jsx(SourceClass, { children: "evita_external_api/evita_external_api_grpc/client/src/main/java/io/evitadb/driver/EvitaClient.java" }), ",\nwhich communicates with the same embedded evitaDB server via gRPC protocol using HTTP/2 and local network. The server\nopens a free port, generates self-signed ", _jsx(Term, { location: "/documentation/user/en/operate/tls.md", children: "certificate authority" }), "\ncertificate. The\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DbInstanceParameterResolver.java" }), "\ncreates a\n", _jsx(SourceClass, { children: "evita_external_api/evita_external_api_grpc/client/src/main/java/io/evitadb/driver/EvitaClient.java" }), "\ninstance that is properly configured to communicate with this gRPC API, the client downloads the self-signed\n", _jsx(Term, { location: "/documentation/user/en/operate/tls.md", children: "certificate authority" }), " certificate and the generic client\ncertificate to pass ", _jsx(_components.a, { href: "../../operate/tls.md#default-mtls-behaviour-not-secure", children: "mTLS verification" }), ", and\ncommunicates with the ", _jsx(_components.em, { children: "embedded evitaDB" }), " over the wire."] })] }), "\n", _jsxs(LS, { to: "g", children: [_jsx(_components.p, { children: "A similar approach is possible with the evitaDB GraphQL API. When setting up your dataset, simply declare that you also\nwant to initialize the GraphQL web server and open required web API:" }), _jsx(SourceCodeTabs, { local: true, children: _jsx(_components.p, { children: _jsx(_components.a, { href: "/documentation/user/en/use/api/example/test-with-prefilled-dataset-and-graphql-web-api.java", children: "Web API test example" }) }) }), _jsxs(_components.p, { children: ["The example is similar to the previous one with the only significant difference - instead of communicating\nwith the embedded evitaDB server via direct method calls, it uses\nexposed GraphQL API,\nwhich communicates with the same embedded evitaDB server via GraphQL protocol using HTTP and local network. The server\nopens a free port and generates self-signed ", _jsx(Term, { location: "/documentation/user/en/operate/tls.md", children: "certificate authority" }), "\ncertificate. The\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DbInstanceParameterResolver.java" }), "\ncreates a\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/tester/GraphQLTester.java" }), "\ninstance that is properly configured to communicate with this GraphQL API, and\ncommunicates with the ", _jsx(_components.em, { children: "embedded evitaDB" }), " over the wire.\nThe ", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/tester/GraphQLTester.java" }), " is essentially\njust a wrapper around the ", _jsx(_components.a, { href: "https://rest-assured.io/", children: "REST-assured" }), " library to provide a pre-configured tester with request\nbuilder specific to our GraphQL API. However, after the ", _jsx(_components.code, { children: ".executeAndThen()" }), " method is called, the request is sent,\nand you can use assertion methods provided directly by the ", _jsx(_components.a, { href: "https://github.com/rest-assured/rest-assured/wiki/Usage#verifying-response-data", children: "REST-assured" }), " library."] })] }), "\n", _jsxs(LS, { to: "r", children: [_jsx(_components.p, { children: "A similar approach is possible with the evitaDB REST API. When setting up your dataset, simply declare that you also\nwant to initialize the REST web server and open required web API:" }), _jsx(SourceCodeTabs, { local: true, children: _jsx(_components.p, { children: _jsx(_components.a, { href: "/documentation/user/en/use/api/example/test-with-prefilled-dataset-and-rest-web-api.java", children: "Web API test example" }) }) }), _jsxs(_components.p, { children: ["The example is similar to the previous one with the only significant difference - instead of communicating\nwith the embedded evitaDB server via direct method calls, it uses\nexposed REST API,\nwhich communicates with the same embedded evitaDB server via REST protocol using HTTP and local network. The server\nopens a free port and generates self-signed ", _jsx(Term, { location: "/documentation/user/en/operate/tls.md", children: "certificate authority" }), "\ncertificate. The\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DbInstanceParameterResolver.java" }), "\ncreates a\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/tester/RestTester.java" }), "\ninstance that is properly configured to communicate with this REST API, and\ncommunicates with the ", _jsx(_components.em, { children: "embedded evitaDB" }), " over the wire.\nThe ", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/tester/RestTester.java" }), " is essentially\njust a wrapper around the ", _jsx(_components.a, { href: "https://rest-assured.io/", children: "REST-assured" }), " library to provide a pre-configured tester with request\nbuilder specific to our REST API. However, after the ", _jsx(_components.code, { children: ".executeAndThen()" }), " method is called, the request is sent,\nand you can use assertion methods provided directly by the ", _jsx(_components.a, { href: "https://github.com/rest-assured/rest-assured/wiki/Usage#verifying-response-data", children: "REST-assured" }), " library."] })] }), "\n", _jsxs(LS, { to: "j,g,r", children: [_jsx(_components.h3, { id: "init-shared-data-objects", children: "Init shared data objects" }), _jsxs(_components.p, { children: ["In the initialization method marked with the ", _jsx(_components.code, { children: "@DataSet" }), " annotation, you can create a set of additional objects that will\nbe associated with the test dataset of such name and will be available for ", _jsx(Term, { children: "autowiring" }), " in any of your\ntests along with other evitaDB related objects. Let's have a look at the following example:"] }), _jsx(SourceCodeTabs, { local: true, children: _jsx(_components.p, { children: _jsx(_components.a, { href: "/documentation/user/en/use/api/example/test-company-objects.java", children: "Company objects initialization" }) }) }), _jsxs(_components.p, { children: ["In the initial method we return a special\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DataCarrier.java" }), ". It is\na wrapper around a ", _jsx(_components.a, { href: "https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/Map.html", children: "Map" }), " that carries\nthe shared object ", _jsx(_components.em, { children: "name" }), " and the ", _jsx(_components.em, { children: "value" }), ". All such objects that are returned in a\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DataCarrier.java" }), " will be\navailable for ", _jsx(Term, { children: "autowiring" }), " in the input arguments of a test method. The arguments are ", _jsx(Term, { name: "autowiring", children: "autowired" }), " primarily by their name (and matching type), secondarily by type compatibility.\nIf you only need to propagate a single shared object, it can be returned directly as the return value of the\ninitialization method without wrapping it in a\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/extension/DataCarrier.java" }), "."] }), _jsxs(_components.p, { children: ["You can see that in the test method, we accept ", _jsx(_components.code, { children: "SealedEntity brand" }), " and ", _jsx(_components.code, { children: "String expectedBrandName" }), " arguments that\nexactly match the named values provided in a data carrier of the initialization method."] }), _jsx(_components.h3, { id: "test-isolation", children: "Test isolation" }), _jsxs(_components.p, { children: ["The data set support allows to run multiple isolated evitaDB instances at the same time - completely isolated one from\neach other. This fact allows you to run your integration tests in parallel. You can read more about this technique in\nour blog post ", _jsx(_components.a, { href: "/blog/04-blazing-fast-integration-tests", children: "about blazing fast integration tests" }), "."] }), _jsxs(_components.p, { children: ["Each dataset is stored in a directory with randomized name in the OS temporary folder. When the dataset opens a web API,\nthe opened ports are consulted with ", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/PortManager.java" }), ".\nIt provides the evitaDB web server with information about free ports that can be used for web APIs of the dataset.\nWhen the dataset is destroyed the ports are closed and returned back to\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/PortManager.java" }), "."] }), _jsx(_components.p, { children: "All datasets are switched to read-only mode after they are initially populated, so that the data cannot be\ninadvertently modified in the test implementations and cause problems in different tests running at the same time,\nor reusing the same dataset later." }), _jsxs(_components.p, { children: ["You can switch the dataset to read-write mode, but it's recommended to be aware of this fact and mark the dataset to be\ndestroyed after finishing the test method or the whole test class. All evita session objects that are created and\n", _jsx(Term, { children: "autowired" }), " in the arguments of the test method are created as read-write sessions with\n", _jsx(_components.a, { href: "write-data.md#dry-run-session", children: "dry-run flag enabled" }), ". This means that they will never affect the data in the dataset\noutside the scope of that particular session. This pattern is called the\n", _jsx(_components.a, { href: "http://xunitpatterns.com/Transaction%20Rollback%20Teardown.html", children: "transaction rollback teardown pattern" }), ",\nand it has been used successfully for a long time in the\n", _jsx(_components.a, { href: "https://relentlesscoding.com/posts/automatic-rollback-of-transactions-in-spring-tests/", children: "Spring Framework Tests" }), "."] }), _jsx(_components.h2, { id: "annotations-reference", children: "Annotations reference" }), _jsxs(_components.p, { children: ["All methods annotated with the evitaDB test annotations can declare the following arguments, which will be\n", _jsx(Term, { children: "autowired" }), " by our test support:"] }), _jsxs("dl", { children: [_jsx("dt", { children: _jsx(SourceClass, { children: "evita_api/src/main/java/io/evitadb/api/EvitaContract.java" }) }), "\n", _jsx("dd", { children: "A reference to active instance of the embedded evitaDB." }), "\n", _jsxs("dt", { children: [_jsx(_components.code, { children: "String" }), " catalogName"] }), "\n", _jsx("dd", { children: "Name of the initial catalog inside the evitaDB instance." }), "\n", _jsx("dt", { children: _jsx(SourceClass, { children: "evita_api/src/main/java/io/evitadb/api/EvitaSessionContract.java" }) }), _jsx("dd", { children: _jsxs(_components.p, { children: ["A reference to an open evitaDB read-write session. The session is marked as\n", _jsx(_components.a, { href: "write-data.md#dry-run-session", children: "dry-run" }), " if it's used in a test method annotated with `@UseDataSet' annotation.\nSessions ", _jsx(Term, { name: "autowiring", children: "autowired" }), " to init or teardown methods are purely read-write."] }) }), _jsx("dt", { children: _jsx(SourceClass, { children: "evita_server/src/main/java/io/evitadb/server/EvitaServer.java" }) }), "\n", _jsx("dd", { children: "A reference to active instance of the evitaDB \"web\" server." })] }), _jsxs(_components.p, { children: ["In methods annotated with ", _jsx(_components.code, { children: "@UseDataSet" }), " or ", _jsx(_components.code, { children: "@OnDataSetTearDown" }), " (other than the initialization method), you can also use\nany of the ", _jsx(_components.a, { href: "#init-shared-data-objects", children: "shared objects" }), " initialized and returned by a method annotated with the\n", _jsx(_components.code, { children: "@DataSet" }), " annotation."] }), _jsx(_components.h3, { id: "dataset", children: "@DataSet" }), _jsxs(_components.p, { children: ["The annotation is expected to be placed on a non-test method that prepares a new evitaDB instance with a sample dataset\nto be used in tests. It's analogous to the JUnit ", _jsx(_components.code, { children: "@BeforeEach" }), " method."] }), _jsxs("dl", { children: [_jsx("dt", { children: _jsx(_components.code, { children: "value" }) }), "\n", _jsx("dd", { children: "Defines name of the dataset." }), "\n", _jsx("dt", { children: _jsx(_components.code, { children: "catalogName" }) }), _jsxs("dd", { children: [_jsxs("p", { children: [_jsx(_components.strong, { children: "Default:" }), " ", _jsx(_components.code, { children: "testCatalog" })] }), "\n", _jsx("p", { children: "Defines the catalog name for the initial catalog created in a new evitaDB instance." })] }), _jsx("dt", { children: _jsx(_components.code, { children: "expectedCatalogState" }) }), _jsxs("dd", { children: [_jsxs("p", { children: [_jsx(_components.strong, { children: "Default:" }), " ", _jsx(_components.code, { children: "ALIVE" })] }), "\n", _jsx("p", { children: "Defines the state of the initial catalog. By default, when the initial dataset is set up, the catalog is\nswitched to transactional mode so that multiple sessions can be opened in this catalog (multiple tests can\naccess the contents of this catalog in parallel)." })] }), _jsx("dt", { children: _jsx(_components.code, { children: "openWebApi" }) }), _jsxs("dd", { children: [_jsxs("p", { children: [_jsx(_components.strong, { children: "Default:" }), " ", _jsx(_components.code, { children: "none" })] }), "\n", _jsx("p", { children: "Specifies a set of web APIs to open for this dataset. Valid values are:" }), _jsxs("ul", { children: [_jsxs("li", { children: [_jsx(_components.code, { children: "gRPC" }), " (", _jsx(_components.code, { children: "GrpcProvider.CODE" }), ") - for gRPC web API (requires the system API)"] }), "\n", _jsxs("li", { children: [_jsx(_components.code, { children: "system" }), " (", _jsx(_components.code, { children: "SystemProvider.CODE" }), ") - system API that provides access to the certificates"] }), "\n", _jsxs("li", { children: [_jsx(_components.code, { children: "rest" }), " (", _jsx(_components.code, { children: "RestProvider.CODE" }), ") - for REST web API"] }), "\n", _jsxs("li", { children: [_jsx(_components.code, { children: "graphQL" }), " (", _jsx(_components.code, { children: "GraphQLProvider.CODE" }), ") - for GraphQL web API"] })] })] }), _jsx("dt", { children: _jsx(_components.code, { children: "readOnly" }) }), _jsxs("dd", { children: [_jsxs("p", { children: [_jsx(_components.strong, { children: "Default:" }), " ", _jsx(_components.code, { children: "true" })] }), "\n", _jsx("p", { children: "Marks the record as read-only after the initialization method completes. This is a safety lock. If you need\nto write to a dataset from the unit test methods, you probably don't want to share it with other tests, or only\na controlled subset of them (usually in the same test class)." }), "\n", _jsxs("p", { children: ["If you disable the readOnly safety lock, you should probably set the ", _jsx(_components.code, { children: "destroyAfterClass" }), " or\n", _jsx(_components.code, { children: "destroyAfterTest" }), " attributes to ", _jsx(_components.code, { children: "true" }), "."] }), "\n", _jsxs("p", { children: ["That's why ", _jsx(_components.code, { children: "readOnly" }), " is set to ", _jsx(_components.code, { children: "true" }), " by default, we want you to think about it before you turn off this\nsafety lock."] })] }), _jsx("dt", { children: _jsx(_components.code, { children: "destroyAfterClass" }) }), _jsxs("dd", { children: [_jsxs("p", { children: [_jsx(_components.strong, { children: "Default:" }), " ", _jsx(_components.code, { children: "false" })] }), "\n", _jsxs("p", { children: ["If set to true, the evitaDB server instance will be closed and deleted after all test methods of the test\nclass in which the ", _jsx(_components.code, { children: "@DataSet" }), " annotation is declared have been executed."] }), "\n", _jsx("p", { children: "By default, the dataset remains active so that other test classes can reuse it. Please make sure that there\nare not multiple (different) versions of the dataset initialization methods that execute the dataset\ndifferently. The recommended approach is to have one abstract class with one setup method implementation and\nmultiple tests that extend from it and use the same dataset." }), "\n", _jsx("p", { children: "If you have different implementations of the record initialization method, there is no guarantee which\nversion will be called first and which will be skipped (due to the existence of the initialized record)." })] })] }), _jsx(_components.h3, { id: "usedataset", children: "@UseDataSet" }), _jsxs(_components.p, { children: ["The annotation is expected to be placed on the ", _jsx(_components.code, { children: "@Test" }), " method or an argument of that method. It associates the argument\n/ method with the dataset initialized by the ", _jsx(_components.a, { href: "#dataset", children: _jsx(_components.code, { children: "@DataSet" }) }), " method."] }), _jsxs("dl", { children: [_jsx("dt", { children: _jsx(_components.code, { children: "value" }) }), "\n", _jsx("dd", { children: "Defines name of the dataset to be used." }), "\n", _jsx("dt", { children: _jsx(_components.code, { children: "destroyAfterTest" }) }), _jsxs("dd", { children: [_jsxs("p", { children: [_jsx(_components.strong, { children: "Default:" }), " ", _jsx(_components.code, { children: "false" })] }), "\n", _jsx("p", { children: "If set to true, the evitaDB server instance will be closed and deleted after this test method has finished." }), "\n", _jsx("p", { children: "It's better to share a single dataset between multiple test methods, but if you know that writing to it\nwithin the test method will significantly damage the dataset, it's better to discard it completely and let the\nsystem prepare a new one." })] })] })] }), "\n", _jsx(LS, { to: "j", children: _jsxs(_components.p, { children: ["Besides the standard ", _jsx(_components.a, { href: "#annotations-reference", children: "autowired arguments" }), " you can also inject\n", _jsx(SourceClass, { children: "evita_external_api/evita_external_api_grpc/client/src/main/java/io/evitadb/driver/EvitaClient.java" }), "\nto any of the defined arguments. The client will open a gRPC connection to the web API of\n", _jsx(SourceClass, { children: "evita_server/src/main/java/io/evitadb/server/EvitaServer.java" }), " and you can start communicating\nwith the server over the network even if the server is running locally as an embedded database."] }) }), "\n", _jsx(LS, { to: "g", children: _jsxs(_components.p, { children: ["Besides the standard ", _jsx(_components.a, { href: "#annotations-reference", children: "autowired arguments" }), " you can also inject\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/tester/GraphQLTester.java" }), "\nto any of the defined arguments. The tester will open a GraphQL connection to the web API of\n", _jsx(SourceClass, { children: "evita_server/src/main/java/io/evitadb/server/EvitaServer.java" }), " and you can start communicating\nwith the server over the network even if the server is running locally as an embedded database."] }) }), "\n", _jsx(LS, { to: "r", children: _jsxs(_components.p, { children: ["Besides the standard ", _jsx(_components.a, { href: "#annotations-reference", children: "autowired arguments" }), " you can also inject\n", _jsx(SourceClass, { children: "evita_test_support/src/main/java/io/evitadb/test/tester/RestTester.java" }), "\nto any of the defined arguments. The tester will open a REST connection to the web API of\n", _jsx(SourceClass, { children: "evita_server/src/main/java/io/evitadb/server/EvitaServer.java" }), " and you can start communicating\nwith the server over the network even if the server is running locally as an embedded database."] }) }), "\n", _jsxs(LS, { to: "j,g,r", children: [_jsx(_components.h3, { id: "ondatasetteardown", children: "@OnDataSetTearDown" }), _jsxs(_components.p, { children: ["Annotation is expected to be placed on non-test method. The method is called by the framework just before the dataset\nwith the given name is closed and destroyed. It's analogous to the JUnit ", _jsx(_components.code, { children: "@AfterEach" }), " method. Usually you don't need to\ndo anything, since we take care of properly closing all things related to evitaDB. We also call the ", _jsx(_components.code, { children: "close" }), "\nmethod on all ", _jsx(_components.a, { href: "#init-shared-data-objects", children: "shared objects" }), " that implement Java's ", _jsx(_components.code, { children: "AutoCloseable" }), " interface. But sometimes\nyou'd need a special cleanup procedure for your shared objects, and you might appreciate this destroy callback support."] }), _jsxs("dl", { children: [_jsx("dt", { children: _jsx(_components.code, { children: "value" }) }), "\n", _jsx("dd", { children: "Defines name of the associated dataset." })] })] })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = Object.assign({}, _provideComponents(), props.components); return MDXLayout ? _jsx(MDXLayout, Object.assign({}, props, { children: _jsx(_createMdxContent, props) })) : _createMdxContent(props); } return { default: MDXContent }; function _missingMdxReference(id, component) { throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it."); }

Write tests