Watson Retrieve and Rank：使用 Web UI 与应用程序询问时的答案差异
Watson Retrieve & Rank : Difference in answer when asked using Web UI versus an application
请看这个 JSON 当被问到这个问题时返回：Optional 的基本方法是什么？这不是检索和排名工具中返回的完美匹配答案（粘贴在此 JSON 片段下方）。你能帮我理解为什么会这样吗？
{
"context": {
"conversation_id": "f87c08f1-2122-4d44-b0bc-d05cd458162d",
"system": {
"dialog_stack": "[root]",
"dialog_turn_counter": "1.0",
"dialog_request_counter": "1.0"
}
},
"inquiryText": "what are the basic methods of Optional",
"responseText": "Going to get answers from Devoxx corpus, ",
"resources": [
{
"id": "\"50a305ba-f8fd-4470-afde-884df5170e29\"",
"score": "1.5568095",
"title": "\"no-title\"",
"body": "\"Voxxed JUnit 5 – The Basics Nicolai Parlog 5 months ago Categories: Methodology Tags: java , JUnit , JUnit 5 19 SHARES Facebook Twitter Reddit Google Mail Linkedin Digg Stumbleupon Buffer Last time, we set up JUnit 5 to be able to write tests. So let’s do it! Overview This post is part of a series about JUnit 5: Setup Basics Architecture Conditions Injection … Most of what you will read here and more can be found in the emerging JUnit 5 user guide . Note that it is based on an alpha version and hence subject to change.Indeed, we are encouraged to open issues or pull requests so that JUnit 5 can improve further. Please make use of this opportunity! It is our chance to help JUnit help us, so if something you see here could be improved, make sure to take it upeam .This post will get updated when it becomes necessary. The code samples I show here can be found on GitHub . Philosophy The new architecture, which we will discuss another time, is aimed at extensibility. It is possible that someday very alien (at least to us run-of-the-mill Java devs) testing techniques will be possible with JUnit 5. But for now the basics are very similar to the current version 4. JUnit 5’s surface undergoes a deliberately incremental improvement and developers should feel right at home. At least I do and I think you will, too: Basic Lifecycle And Features class Lifecycle { @BeforeAll static void initializeExternalResources() { System.out.println(\\"Initializing external resources...\\"); } @BeforeEach void initializeMockObjects() { System.out.println(\\"Initializing mock objects...\\"); } @Test void someTest() { System.out.println(\\"Running some test...\\"); assertTrue(true); } @Test void otherTest() { assumeTrue(true); System.out.println(\\"Running another test...\\"); assertNotEquals(1, 42, \\"Why wouldn't these be the same?\\"); } @Test @Disabled void disabledTest() { System.exit(1); } @AfterEach void tearDown() { System.out.println(\\"Tearing down...\\"); } @AfterAll static void freeExternalResources() { System.out.println(\\"Freeing external resources...\\"); } } See? No big surprises. The Basics Of JUnit 5 Visibility The most obvious change is that test classes and methods do not have to be public anymore. Package visibility suffices but private does not. I think this is a sensible choice and in line with how we intuit the different visibility modifiers. Great! I’d say, less letters to type but you haven’t been doing that manually anyways, right? Still less boilerplate to ignore while scrolling through a test class. Test Lifecycle @Test The most basic JUnit annotation is @Test, which marks methods that are to be run as tests. It is virtually unchanged, although it no longer takes optional arguments. Expected exceptions can now be verified via assertions but as far as I know there is not yet a replacement for timeouts . JUnit 5 creates a new test instance for each test method (same as JUnit 4). Before And After You might want to run code to set up and tear down your tests. There are four method annotations to help you do that: @BeforeAll Executed once; runs before the tests and methods marked with @BeforeEach. @BeforeEach Executed before each test. @AfterEach Executed after each test. @AfterAll Executed once; runs after all tests and methods marked with @AfterEach. Because a new instance is created for each test, there is no obvious instance on which to call the @BeforeAll/ @AfterAll methods, so they have to be static. The order in which different methods annotated with the same annotation are executed is undefined. As far as I can tell the same is true for inherited methods. Whether it should be possible to define an order is currently being discussed . Except in name, these annotations work exactly like in JUnit 4. While not uncommon , I am not convinced of the names, though. See this issue for details. Disabling Tests It’s Friday afternoon and you just want to go home? No problem, just slap@Disabled on the test (optionally giving a reason) and run. A Disabled Test @Test @Disabled(\\"Y U No Pass?!\\") void failingTest() { assertTrue(false); } Test Class Lifecycle Compared to the prototype it is interesting to note that the test class lifecycle didn’t make it into the alpha version. It would run all tests on the same instance of the test class, thus allowing the tests to interact with each other by mutating state. As I already wrote while discussing the prototype: I think this is a typical case of a feature that is harmful in 99% of the cases but indispensable in the other 1%. Considering the very real risk of horrible inter-test-dependencies I’d say it was a good thing that it was taken out in its original form. But the JUnit team is discussing ways to bring it back in with a different name and added semantics. This would make its use very deliberate. What do you think? Assertions If @Test, @Before..., and @After... are a test suite’s skeleton, assertions are its heart. After the instance under test was prepared and the functionality to test was executed on it, assertions make sure that the desired properties hold. If they don’t, they fail the running test. Classic Classic assertions either check a property of a single instance (e.g. that it is not null) or do some kind of comparison (e.g. that two instances are equal). In both cases they optionally take a message as a last parameter, which is shown when the assertion fails. If constructing the message is expensive, it can be specified as a lambda expression, so construction is delayed until the message is actually required. Classic Assertions @Test void assertWithBoolean() { assertTrue(true); assertTrue(this::truism); assertFalse(false, () -> \\"Really \\" + \\"expensive \\" + \\"message\\" + \\".\\"); } boolean truism() { return true; } @Test void assertWithComparison() { List expected = asList(\\"element\\"); List actual = new LinkedList<>(expected); assertEquals(expected, actual); assertEquals(expected, actual, \\"Should be equal.\\"); assertEquals(expected, actual, () -> \\"Should \\" + \\"be \\" + \\"equal.\\"); assertNotSame(expected, actual, \\"Obviously not the same instance.\\"); } As you can see JUnit 5 doesn’t change much here. The names are the same as before and comparative assertions still take a pair of an expected and an actual value (in that order). That the expected-actual order is so critical in understanding the test’s failure message and intention, but can be mixed up so easily is a big blind spot. There’s nothing much to do, though, except to create a new assertion framework. Considering big players like Hamcrest (ugh!) or AssertJ (yeah!), this would not have been a sensible way to invest the limited time. Hence the goal was to keep the assertions focused and effort-free. New is that failure message come last. I like it because it keeps the eye on the ball, i.e. the property being asserted. As a nod to Java 8, Boolean assertions now accept suppliers , which is a nice detail. Extended Aside from the classical assertions that check specific properties, there are a couple of others. The first is not even a real assertion, it just fails the test with a failure message. 'fail' @Test void failTheTest() { fail(\\"epicly\\"); } Then we have assertAll, which takes a variable number of assertions and tests them all before reporting which failed (if any). @Test void assertAllProperties() { Address address = new Address(\\"New City\\", \\"Some Street\\", \\"No\\"); assertAll(\\"address\\", () -> assertEquals(\\"Neustadt\\", address.city), () -> assertEquals(\\"Irgendeinestraße\\", address.street), () -> assertEquals(\\"Nr\\", address.number) ); } Failure Message for ‘AssertALL’ org.opentest4j.MultipleFailuresError: address (3 failures) expected: but was: expected: but was: expected: but was: This is great to check a number of related properties and get values for all of them as opposed to the common behavior where the test reports the first one that failed and you never know the other values. Finally we have assertThrows and expectThrows. Both fail the test if the given method does not throw the specified exception. The latter also returns the exceptions so it can be used for further verifications, e.g. asserting that the message contains certain information. @Test void assertExceptions() { assertThrows(Exception.class, this::throwing); Exception exception = expectThrows(Exception.class, this::throwing); assertEquals(\\"Because I can!\\", exception.getMessage()); } Assumptions Assumptions allow to only run tests if certain conditions are as expected. This can be used to reduce the run time and verbosity of test suites, especially in the failure case. @Test void exitIfFalseIsTrue() { assumeTrue(false); System.exit(1); } @Test void exitIfTrueIsFalse() { assumeFalse(this::truism); System.exit(1); } private boolean truism() { return true; } @Test void exitIfNullEqualsString() { assumingThat( \\"null\\".equals(null), () -> System.exit(1) ); } Assumptions can either be used to abort tests whose preconditions are not met or to execute (parts of) a test only if a condition holds. The main difference is that aborted tests are reported as disabled, whereas a test that was empty because a condition did not hold is plain green. Nesting Tests JUnit 5 makes it near effortless to nest test classes. Simply annotate inner classes with @Nested and all test methods in there will be executed as well: package org.codefx.demo.junit5;// NOT_PUBLISHED import org.junit.gen5.api.BeforeEach; import org.junit.gen5.api.Nested; import org.junit.gen5.api.Test; import static org.junit.gen5.api.Assertions.assertEquals; import static org.junit.gen5.api.Assertions.assertTrue; class Nest { int count = Integer.MIN_VALUE; @BeforeEach void setCountToZero() { count = 0; } @Test void countIsZero() { assertEquals(0, count); } @Nested class CountGreaterZero { @BeforeEach void increaseCount() { count++; } @Test void countIsGreaterZero() { assertTrue(count > 0); } @Nested class CountMuchGreaterZero { @BeforeEach void increaseCount() { count += Integer.MAX_VALUE / 2; } @Test void countIsLarge() { assertTrue(count > Integer.MAX_VALUE / 2); } } } } As you can see, @BeforeEach (and @AfterEach) work here as well. Although currently not documented the initializations are executed outside-in. This allows to incrementally build a context for the inner tests. For nested tests to have access to the outer test class’ fields, the nested class must not be static. Unfortunately this forbids the use of static methods so @BeforeAll and@AfterAll can not be used in that scenario. ( Or can they? ) Maybe you’re asking yourself what this is good for. I use nested test classes to inherit interface tests , others to keep their test classes small and focused . The latter is also demonstrated by the more elaborate example commonly given by the JUnit team , which tests a stack: class TestingAStack { Stack stack; boolean isRun = false; @Test void isInstantiatedWithNew() { new Stack(); } @Nested class WhenNew { @BeforeEach void init() { stack = new Stack(); } // some tests on 'stack', which is empty @Nested class AfterPushing { String anElement = \\"an element\\"; @BeforeEach void init() { stack.push(anElement); } // some tests on 'stack', which has one element... } } } In this example the state is successively changed and a number of tests are executed for each scenario. Naming Tests JUnit 5 comes with an annotation @DisplayName, which gives developers the possibility to give more easily readable names to their test classes and methods. With it, the stack example which looks as follows: @DisplayName(\\"A stack\\") class TestingAStack { @Test @DisplayName(\\"is instantiated with new Stack()\\") void isInstantiatedWithNew() { /*…*/ } @Nested @DisplayName(\\"when new\\") class WhenNew { @Test @DisplayName(\\"is empty\\") void isEmpty() { /*…*/ } @Test @DisplayName(\\"throws EmptyStackException when popped\\") void throwsExceptionWhenPopped() { /*…*/ } @Test @DisplayName(\\"throws EmptyStackException when peeked\\") void throwsExceptionWhenPeeked() { /*…*/ } @Nested @DisplayName(\\"after pushing an element\\") class AfterPushing { @Test @DisplayName(\\"it is no longer empty\\") void isEmpty() { /*…*/ } @Test @DisplayName(\\"returns the element when popped and is empty\\") void returnElementWhenPopped() { /*…*/ } @Test @DisplayName( \\"returns the element when peeked but remains not empty\\") void returnElementWhenPeeked(){ /*…*/ } } } } This creates nicely readable output and should bring joy to the heart of BDD ‘ers! Reflection That’s it, you made it! We rushed through the basics of how to use JUnit 5 and now you know all you need to write plain tests: How to annotate the lifecycle methods (with @[Before|After][All|Each]) and the test methods themselves ( @Test), how to nest ( @Nested) and name ( @DisplayName) tests and how assertions and assumptions work (much like before). But wait, there’s more! We didn’t yet talk about conditional execution of tests methods, the very cool parameter injection, the extension mechanism, or the project’s architecture. And we won’t right now because we will take a short break from JUnit 5 and come back to it in about a month. Stay tuned! Window size: x Viewport size: x\"",
"docName": "\"JUnit 5 – The Basics - Voxxed.htm\""
},
{
"id": "\"0054b4e9-6b55-420e-84bc-8f31c79a949f\"",
"score": "1.2038735",
"title": "\"By Stefan Bulzan\"",
"body": "\"With the advent of lambdas in Java we now have a new tool to better design our code. Of course, the first step is using streams, method references and other neat features introduced in Java 8. Going forward I think the next step is to revisit the well established Design Patterns and see them through the functional programming lenses. For this purpose I’ll take the Decorator Pattern and implement it using lambdas. We’ll take an easy and delicious example of the Decorator Pattern: adding toppings to pizza. Here is the standard implementation as suggested by GoF: First we have the interface that defines our component: public interface Pizza { String bakePizza(); } We have a concrete component: public class BasicPizza implements Pizza { @Override public String bakePizza() { return \\"Basic Pizza\\"; } } We decide that we have to decorate our component in different ways. We go with Decorator Pattern. This is the abstract decorator: public abstract class PizzaDecorator implements Pizza { private final Pizza pizza; protected PizzaDecorator(Pizza pizza) { this.pizza = pizza; } @Override public String bakePizza() { return pizza.bakePizza(); } } We provide some concrete decorators for the component: public class ChickenTikkaPizza extends PizzaDecorator { protected ChickenTikkaPizza(Pizza pizza) { super(pizza); } @Override public String bakePizza() { return super.bakePizza() + \\" with chicken topping\\"; } } public class ProsciuttoPizza extends PizzaDecorator { protected ProsciuttoPizza(Pizza pizza) { super(pizza); } @Override public String bakePizza() { return super.bakePizza() + \\" with prosciutto\\"; } } And this is the way to use the new structure: Pizza pizza = new ChickenTikkaPizza(new BasicPizza()); String finishedPizza = pizza.bakePizza(); //Basic Pizza with chicken topping pizza = new ChickenTikkaPizza(new ProsciuttoPizza(new BasicPizza())); finishedPizza = pizza.bakePizza(); //Basic Pizza with prosciutto with chicken topping We can see that this can get very messy, and it did get very messy if we think about how we handle buffered readers in Java: new DataInputStream(new BufferedInputStream(new FileInputStream(new File(\\"myfile.txt\\")))) Of course, you can split that in multiple lines, but that won’t solve the messiness, it will just spread it. Now lets see how we can do the same thing using lambdas. We start with the same basic component objects: public interface Pizza { String bakePizza(); } public class BasicPizza implements Pizza { @Override public String bakePizza() { return \\"Basic Pizza\\"; } } But now instead of declaring an abstract class that will provide the template for decorations, we will create the decorator that asks the user for functions that will decorate the component. public class PizzaDecorator { private final Function toppings; private PizzaDecorator(Function... desiredToppings) { this.toppings = Stream.of(desiredToppings) .reduce(Function.identity(), Function::andThen); } public static String bakePizza(Pizza pizza, Function... desiredToppings) { return new PizzaDecorator(desiredToppings).bakePizza(pizza); } private String bakePizza(Pizza pizza) { return this.toppings.apply(pizza).bakePizza(); } } There is this line that constructs the chain of decorations to be applied: Stream.of(desiredToppings).reduce(identity(), Function::andThen); This line of code will take your decorations (which are of Function type) and chain them using andThen. This is the same as… (currentToppings, nextTopping) -> currentToppings.andThen(nextTopping) And it makes sure that the functions are called subsequently in the order you provided. Also, Function.identity() is translated to elem -> elem lambda expression. OK, now where will we define our decorations? Well, you can add them as static methods in PizzaDecorator or even in the interface: public interface Pizza { String bakePizza(); static Pizza withChickenTikka(Pizza pizza) { return new Pizza() { @Override public String bakePizza() { return pizza.bakePizza() + \\" with chicken\\"; } }; } static Pizza withProsciutto(Pizza pizza) { return new Pizza() { @Override public String bakePizza() { return pizza.bakePizza() + \\" with prosciutto\\"; } }; } } And now, this is how this pattern gets to be used: String finishedPizza = PizzaDecorator.bakePizza(new BasicPizza(),Pizza::withChickenTikka, Pizza::withProsciutto); //And if you static import PizzaDecorator.bakePizza: String finishedPizza = bakePizza(new BasicPizza(),Pizza::withChickenTikka, Pizza::withProsciutto); As you can see, the code got more clear and more concise, and we didn’t use inheritance to build our decorators. This is just one of the many design patterns that can be improved using lambdas. There are more features that can be used to improve the rest of them like using partial application (currying) to implement Adapter Pattern. I hope I got you thinking about adopting a more functional programming approach to your development style.\"",
"docName": "\"Decorator Design Pattern Using Lambdas - Voxxed.htm\""
}
]
}
当您使用训练有素的排名器 ID 向 R&R 提交查询时，它将从服务的检索端获取响应，并使用排名器根据排名器的内容对它们进行排序[=30= 】 关于相关性。
您首先从检索服务中获取的行数对此至关重要。
以极端情况为例，如果您只获取一行，那么您对排序器进行了何种训练都无关紧要。它只有一件事需要整理。所以它会 return 那一件事。
如果您获取少量行，例如 3 行，您将检索这三行，然后排名器会对它们进行排序。您将始终获得相同的三行 - 排序器的不同之处在于它们的排列顺序。
如果您获取非常多的行，例如 100，则排名器有 100 个结果要排序，因此此类查询的最佳答案可能与您的最佳答案不同只拿下前几名。
当比较两个不同应用程序查询 R&R 服务的最佳结果时，必须考虑行参数。
您包含截图的网络工具使用的行参数为 30。它检索 30 行，然后使用您选择的排名器对它们进行排序并显示最靠前的结果。
我的猜测是您的应用程序要么将行设置为不同的值，要么根本不设置它并使用默认值 10。如果您将应用程序中的 rows 参数设置为 30，匹配网络工具在做什么，我希望结果是一致的。
此处有更多关于行参数的背景信息：https://www.ibm.com/watson/developercloud/doc/retrieve-rank/training_data.shtml
请看这个 JSON 当被问到这个问题时返回：Optional 的基本方法是什么？这不是检索和排名工具中返回的完美匹配答案（粘贴在此 JSON 片段下方）。你能帮我理解为什么会这样吗？
{
"context": {
"conversation_id": "f87c08f1-2122-4d44-b0bc-d05cd458162d",
"system": {
"dialog_stack": "[root]",
"dialog_turn_counter": "1.0",
"dialog_request_counter": "1.0"
}
},
"inquiryText": "what are the basic methods of Optional",
"responseText": "Going to get answers from Devoxx corpus, ",
"resources": [
{
"id": "\"50a305ba-f8fd-4470-afde-884df5170e29\"",
"score": "1.5568095",
"title": "\"no-title\"",
"body": "\"Voxxed JUnit 5 – The Basics Nicolai Parlog 5 months ago Categories: Methodology Tags: java , JUnit , JUnit 5 19 SHARES Facebook Twitter Reddit Google Mail Linkedin Digg Stumbleupon Buffer Last time, we set up JUnit 5 to be able to write tests. So let’s do it! Overview This post is part of a series about JUnit 5: Setup Basics Architecture Conditions Injection … Most of what you will read here and more can be found in the emerging JUnit 5 user guide . Note that it is based on an alpha version and hence subject to change.Indeed, we are encouraged to open issues or pull requests so that JUnit 5 can improve further. Please make use of this opportunity! It is our chance to help JUnit help us, so if something you see here could be improved, make sure to take it upeam .This post will get updated when it becomes necessary. The code samples I show here can be found on GitHub . Philosophy The new architecture, which we will discuss another time, is aimed at extensibility. It is possible that someday very alien (at least to us run-of-the-mill Java devs) testing techniques will be possible with JUnit 5. But for now the basics are very similar to the current version 4. JUnit 5’s surface undergoes a deliberately incremental improvement and developers should feel right at home. At least I do and I think you will, too: Basic Lifecycle And Features class Lifecycle { @BeforeAll static void initializeExternalResources() { System.out.println(\\"Initializing external resources...\\"); } @BeforeEach void initializeMockObjects() { System.out.println(\\"Initializing mock objects...\\"); } @Test void someTest() { System.out.println(\\"Running some test...\\"); assertTrue(true); } @Test void otherTest() { assumeTrue(true); System.out.println(\\"Running another test...\\"); assertNotEquals(1, 42, \\"Why wouldn't these be the same?\\"); } @Test @Disabled void disabledTest() { System.exit(1); } @AfterEach void tearDown() { System.out.println(\\"Tearing down...\\"); } @AfterAll static void freeExternalResources() { System.out.println(\\"Freeing external resources...\\"); } } See? No big surprises. The Basics Of JUnit 5 Visibility The most obvious change is that test classes and methods do not have to be public anymore. Package visibility suffices but private does not. I think this is a sensible choice and in line with how we intuit the different visibility modifiers. Great! I’d say, less letters to type but you haven’t been doing that manually anyways, right? Still less boilerplate to ignore while scrolling through a test class. Test Lifecycle @Test The most basic JUnit annotation is @Test, which marks methods that are to be run as tests. It is virtually unchanged, although it no longer takes optional arguments. Expected exceptions can now be verified via assertions but as far as I know there is not yet a replacement for timeouts . JUnit 5 creates a new test instance for each test method (same as JUnit 4). Before And After You might want to run code to set up and tear down your tests. There are four method annotations to help you do that: @BeforeAll Executed once; runs before the tests and methods marked with @BeforeEach. @BeforeEach Executed before each test. @AfterEach Executed after each test. @AfterAll Executed once; runs after all tests and methods marked with @AfterEach. Because a new instance is created for each test, there is no obvious instance on which to call the @BeforeAll/ @AfterAll methods, so they have to be static. The order in which different methods annotated with the same annotation are executed is undefined. As far as I can tell the same is true for inherited methods. Whether it should be possible to define an order is currently being discussed . Except in name, these annotations work exactly like in JUnit 4. While not uncommon , I am not convinced of the names, though. See this issue for details. Disabling Tests It’s Friday afternoon and you just want to go home? No problem, just slap@Disabled on the test (optionally giving a reason) and run. A Disabled Test @Test @Disabled(\\"Y U No Pass?!\\") void failingTest() { assertTrue(false); } Test Class Lifecycle Compared to the prototype it is interesting to note that the test class lifecycle didn’t make it into the alpha version. It would run all tests on the same instance of the test class, thus allowing the tests to interact with each other by mutating state. As I already wrote while discussing the prototype: I think this is a typical case of a feature that is harmful in 99% of the cases but indispensable in the other 1%. Considering the very real risk of horrible inter-test-dependencies I’d say it was a good thing that it was taken out in its original form. But the JUnit team is discussing ways to bring it back in with a different name and added semantics. This would make its use very deliberate. What do you think? Assertions If @Test, @Before..., and @After... are a test suite’s skeleton, assertions are its heart. After the instance under test was prepared and the functionality to test was executed on it, assertions make sure that the desired properties hold. If they don’t, they fail the running test. Classic Classic assertions either check a property of a single instance (e.g. that it is not null) or do some kind of comparison (e.g. that two instances are equal). In both cases they optionally take a message as a last parameter, which is shown when the assertion fails. If constructing the message is expensive, it can be specified as a lambda expression, so construction is delayed until the message is actually required. Classic Assertions @Test void assertWithBoolean() { assertTrue(true); assertTrue(this::truism); assertFalse(false, () -> \\"Really \\" + \\"expensive \\" + \\"message\\" + \\".\\"); } boolean truism() { return true; } @Test void assertWithComparison() { List expected = asList(\\"element\\"); List actual = new LinkedList<>(expected); assertEquals(expected, actual); assertEquals(expected, actual, \\"Should be equal.\\"); assertEquals(expected, actual, () -> \\"Should \\" + \\"be \\" + \\"equal.\\"); assertNotSame(expected, actual, \\"Obviously not the same instance.\\"); } As you can see JUnit 5 doesn’t change much here. The names are the same as before and comparative assertions still take a pair of an expected and an actual value (in that order). That the expected-actual order is so critical in understanding the test’s failure message and intention, but can be mixed up so easily is a big blind spot. There’s nothing much to do, though, except to create a new assertion framework. Considering big players like Hamcrest (ugh!) or AssertJ (yeah!), this would not have been a sensible way to invest the limited time. Hence the goal was to keep the assertions focused and effort-free. New is that failure message come last. I like it because it keeps the eye on the ball, i.e. the property being asserted. As a nod to Java 8, Boolean assertions now accept suppliers , which is a nice detail. Extended Aside from the classical assertions that check specific properties, there are a couple of others. The first is not even a real assertion, it just fails the test with a failure message. 'fail' @Test void failTheTest() { fail(\\"epicly\\"); } Then we have assertAll, which takes a variable number of assertions and tests them all before reporting which failed (if any). @Test void assertAllProperties() { Address address = new Address(\\"New City\\", \\"Some Street\\", \\"No\\"); assertAll(\\"address\\", () -> assertEquals(\\"Neustadt\\", address.city), () -> assertEquals(\\"Irgendeinestraße\\", address.street), () -> assertEquals(\\"Nr\\", address.number) ); } Failure Message for ‘AssertALL’ org.opentest4j.MultipleFailuresError: address (3 failures) expected: but was: expected: but was: expected: but was: This is great to check a number of related properties and get values for all of them as opposed to the common behavior where the test reports the first one that failed and you never know the other values. Finally we have assertThrows and expectThrows. Both fail the test if the given method does not throw the specified exception. The latter also returns the exceptions so it can be used for further verifications, e.g. asserting that the message contains certain information. @Test void assertExceptions() { assertThrows(Exception.class, this::throwing); Exception exception = expectThrows(Exception.class, this::throwing); assertEquals(\\"Because I can!\\", exception.getMessage()); } Assumptions Assumptions allow to only run tests if certain conditions are as expected. This can be used to reduce the run time and verbosity of test suites, especially in the failure case. @Test void exitIfFalseIsTrue() { assumeTrue(false); System.exit(1); } @Test void exitIfTrueIsFalse() { assumeFalse(this::truism); System.exit(1); } private boolean truism() { return true; } @Test void exitIfNullEqualsString() { assumingThat( \\"null\\".equals(null), () -> System.exit(1) ); } Assumptions can either be used to abort tests whose preconditions are not met or to execute (parts of) a test only if a condition holds. The main difference is that aborted tests are reported as disabled, whereas a test that was empty because a condition did not hold is plain green. Nesting Tests JUnit 5 makes it near effortless to nest test classes. Simply annotate inner classes with @Nested and all test methods in there will be executed as well: package org.codefx.demo.junit5;// NOT_PUBLISHED import org.junit.gen5.api.BeforeEach; import org.junit.gen5.api.Nested; import org.junit.gen5.api.Test; import static org.junit.gen5.api.Assertions.assertEquals; import static org.junit.gen5.api.Assertions.assertTrue; class Nest { int count = Integer.MIN_VALUE; @BeforeEach void setCountToZero() { count = 0; } @Test void countIsZero() { assertEquals(0, count); } @Nested class CountGreaterZero { @BeforeEach void increaseCount() { count++; } @Test void countIsGreaterZero() { assertTrue(count > 0); } @Nested class CountMuchGreaterZero { @BeforeEach void increaseCount() { count += Integer.MAX_VALUE / 2; } @Test void countIsLarge() { assertTrue(count > Integer.MAX_VALUE / 2); } } } } As you can see, @BeforeEach (and @AfterEach) work here as well. Although currently not documented the initializations are executed outside-in. This allows to incrementally build a context for the inner tests. For nested tests to have access to the outer test class’ fields, the nested class must not be static. Unfortunately this forbids the use of static methods so @BeforeAll and@AfterAll can not be used in that scenario. ( Or can they? ) Maybe you’re asking yourself what this is good for. I use nested test classes to inherit interface tests , others to keep their test classes small and focused . The latter is also demonstrated by the more elaborate example commonly given by the JUnit team , which tests a stack: class TestingAStack { Stack stack; boolean isRun = false; @Test void isInstantiatedWithNew() { new Stack(); } @Nested class WhenNew { @BeforeEach void init() { stack = new Stack(); } // some tests on 'stack', which is empty @Nested class AfterPushing { String anElement = \\"an element\\"; @BeforeEach void init() { stack.push(anElement); } // some tests on 'stack', which has one element... } } } In this example the state is successively changed and a number of tests are executed for each scenario. Naming Tests JUnit 5 comes with an annotation @DisplayName, which gives developers the possibility to give more easily readable names to their test classes and methods. With it, the stack example which looks as follows: @DisplayName(\\"A stack\\") class TestingAStack { @Test @DisplayName(\\"is instantiated with new Stack()\\") void isInstantiatedWithNew() { /*…*/ } @Nested @DisplayName(\\"when new\\") class WhenNew { @Test @DisplayName(\\"is empty\\") void isEmpty() { /*…*/ } @Test @DisplayName(\\"throws EmptyStackException when popped\\") void throwsExceptionWhenPopped() { /*…*/ } @Test @DisplayName(\\"throws EmptyStackException when peeked\\") void throwsExceptionWhenPeeked() { /*…*/ } @Nested @DisplayName(\\"after pushing an element\\") class AfterPushing { @Test @DisplayName(\\"it is no longer empty\\") void isEmpty() { /*…*/ } @Test @DisplayName(\\"returns the element when popped and is empty\\") void returnElementWhenPopped() { /*…*/ } @Test @DisplayName( \\"returns the element when peeked but remains not empty\\") void returnElementWhenPeeked(){ /*…*/ } } } } This creates nicely readable output and should bring joy to the heart of BDD ‘ers! Reflection That’s it, you made it! We rushed through the basics of how to use JUnit 5 and now you know all you need to write plain tests: How to annotate the lifecycle methods (with @[Before|After][All|Each]) and the test methods themselves ( @Test), how to nest ( @Nested) and name ( @DisplayName) tests and how assertions and assumptions work (much like before). But wait, there’s more! We didn’t yet talk about conditional execution of tests methods, the very cool parameter injection, the extension mechanism, or the project’s architecture. And we won’t right now because we will take a short break from JUnit 5 and come back to it in about a month. Stay tuned! Window size: x Viewport size: x\"",
"docName": "\"JUnit 5 – The Basics - Voxxed.htm\""
},
{
"id": "\"0054b4e9-6b55-420e-84bc-8f31c79a949f\"",
"score": "1.2038735",
"title": "\"By Stefan Bulzan\"",
"body": "\"With the advent of lambdas in Java we now have a new tool to better design our code. Of course, the first step is using streams, method references and other neat features introduced in Java 8. Going forward I think the next step is to revisit the well established Design Patterns and see them through the functional programming lenses. For this purpose I’ll take the Decorator Pattern and implement it using lambdas. We’ll take an easy and delicious example of the Decorator Pattern: adding toppings to pizza. Here is the standard implementation as suggested by GoF: First we have the interface that defines our component: public interface Pizza { String bakePizza(); } We have a concrete component: public class BasicPizza implements Pizza { @Override public String bakePizza() { return \\"Basic Pizza\\"; } } We decide that we have to decorate our component in different ways. We go with Decorator Pattern. This is the abstract decorator: public abstract class PizzaDecorator implements Pizza { private final Pizza pizza; protected PizzaDecorator(Pizza pizza) { this.pizza = pizza; } @Override public String bakePizza() { return pizza.bakePizza(); } } We provide some concrete decorators for the component: public class ChickenTikkaPizza extends PizzaDecorator { protected ChickenTikkaPizza(Pizza pizza) { super(pizza); } @Override public String bakePizza() { return super.bakePizza() + \\" with chicken topping\\"; } } public class ProsciuttoPizza extends PizzaDecorator { protected ProsciuttoPizza(Pizza pizza) { super(pizza); } @Override public String bakePizza() { return super.bakePizza() + \\" with prosciutto\\"; } } And this is the way to use the new structure: Pizza pizza = new ChickenTikkaPizza(new BasicPizza()); String finishedPizza = pizza.bakePizza(); //Basic Pizza with chicken topping pizza = new ChickenTikkaPizza(new ProsciuttoPizza(new BasicPizza())); finishedPizza = pizza.bakePizza(); //Basic Pizza with prosciutto with chicken topping We can see that this can get very messy, and it did get very messy if we think about how we handle buffered readers in Java: new DataInputStream(new BufferedInputStream(new FileInputStream(new File(\\"myfile.txt\\")))) Of course, you can split that in multiple lines, but that won’t solve the messiness, it will just spread it. Now lets see how we can do the same thing using lambdas. We start with the same basic component objects: public interface Pizza { String bakePizza(); } public class BasicPizza implements Pizza { @Override public String bakePizza() { return \\"Basic Pizza\\"; } } But now instead of declaring an abstract class that will provide the template for decorations, we will create the decorator that asks the user for functions that will decorate the component. public class PizzaDecorator { private final Function toppings; private PizzaDecorator(Function... desiredToppings) { this.toppings = Stream.of(desiredToppings) .reduce(Function.identity(), Function::andThen); } public static String bakePizza(Pizza pizza, Function... desiredToppings) { return new PizzaDecorator(desiredToppings).bakePizza(pizza); } private String bakePizza(Pizza pizza) { return this.toppings.apply(pizza).bakePizza(); } } There is this line that constructs the chain of decorations to be applied: Stream.of(desiredToppings).reduce(identity(), Function::andThen); This line of code will take your decorations (which are of Function type) and chain them using andThen. This is the same as… (currentToppings, nextTopping) -> currentToppings.andThen(nextTopping) And it makes sure that the functions are called subsequently in the order you provided. Also, Function.identity() is translated to elem -> elem lambda expression. OK, now where will we define our decorations? Well, you can add them as static methods in PizzaDecorator or even in the interface: public interface Pizza { String bakePizza(); static Pizza withChickenTikka(Pizza pizza) { return new Pizza() { @Override public String bakePizza() { return pizza.bakePizza() + \\" with chicken\\"; } }; } static Pizza withProsciutto(Pizza pizza) { return new Pizza() { @Override public String bakePizza() { return pizza.bakePizza() + \\" with prosciutto\\"; } }; } } And now, this is how this pattern gets to be used: String finishedPizza = PizzaDecorator.bakePizza(new BasicPizza(),Pizza::withChickenTikka, Pizza::withProsciutto); //And if you static import PizzaDecorator.bakePizza: String finishedPizza = bakePizza(new BasicPizza(),Pizza::withChickenTikka, Pizza::withProsciutto); As you can see, the code got more clear and more concise, and we didn’t use inheritance to build our decorators. This is just one of the many design patterns that can be improved using lambdas. There are more features that can be used to improve the rest of them like using partial application (currying) to implement Adapter Pattern. I hope I got you thinking about adopting a more functional programming approach to your development style.\"",
"docName": "\"Decorator Design Pattern Using Lambdas - Voxxed.htm\""
}
]
}
当您使用训练有素的排名器 ID 向 R&R 提交查询时，它将从服务的检索端获取响应，并使用排名器根据排名器的内容对它们进行排序[=30= 】 关于相关性。
您首先从检索服务中获取的行数对此至关重要。
以极端情况为例，如果您只获取一行，那么您对排序器进行了何种训练都无关紧要。它只有一件事需要整理。所以它会 return 那一件事。
如果您获取少量行，例如 3 行，您将检索这三行，然后排名器会对它们进行排序。您将始终获得相同的三行 - 排序器的不同之处在于它们的排列顺序。
如果您获取非常多的行，例如 100，则排名器有 100 个结果要排序，因此此类查询的最佳答案可能与您的最佳答案不同只拿下前几名。
当比较两个不同应用程序查询 R&R 服务的最佳结果时，必须考虑行参数。
您包含截图的网络工具使用的行参数为 30。它检索 30 行，然后使用您选择的排名器对它们进行排序并显示最靠前的结果。
我的猜测是您的应用程序要么将行设置为不同的值，要么根本不设置它并使用默认值 10。如果您将应用程序中的 rows 参数设置为 30，匹配网络工具在做什么，我希望结果是一致的。
此处有更多关于行参数的背景信息：https://www.ibm.com/watson/developercloud/doc/retrieve-rank/training_data.shtml