René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"ReadMe is out of date","articleBody":"`Conversation` is deprecated , and `QWenConversationParam` is removed. Please update your doc as follows\n\n```\n## QuickStart\n\n### Conversation\n\nYou can create a conversation client simply by:\n\n```java\n// Use http as the network protocol.\nGeneration generation = new Generation();\n```\n\nThis interface also accept a protocol argument:\n\n```java\nimport com.alibaba.dashscope.common.Protocol;\nGeneration generation = new Generation(Protocol.HTTP.getValue());\nGeneration generation = new Generation(Protocol.WEBSOCKET.getValue());\n```\n\nThe generation interface supports both stream and non-stream queries. These queries all accept `GenerationParam`  as input, and returns `GenerationResult` as output . Each model has a unique input structure and output structure which derives from the two data classes mentioned above. Please use these sub classes when you are using the coordinating model. \n\nHere shows the usages of each method, with the examples of `qwen-turbo` model.\n\n#### Support stream and non-stream mode, accept output from callback\n\n```java\nimport com.alibaba.dashscope.aigc.generation.Generation;\nimport com.alibaba.dashscope.aigc.generation.GenerationParam;\nimport com.alibaba.dashscope.aigc.generation.GenerationResult;\nimport com.alibaba.dashscope.common.Message;\nimport com.alibaba.dashscope.common.ResultCallback;\nimport com.alibaba.dashscope.common.Role;\nimport com.alibaba.dashscope.exception.ApiException;\nimport com.alibaba.dashscope.exception.InputRequiredException;\nimport com.alibaba.dashscope.exception.NoApiKeyException;\nimport com.alibaba.dashscope.utils.JsonUtils;\nimport java.util.Arrays;\n\npublic class Main {\n\n  public static void main(String[] args) {\n      Generation generation = new Generation();\n      GenerationParam param = GenerationParam.builder()\n          .apiKey(System.getenv(\"DASHSCOPE_API_KEY\"))\n          .model(Generation.Models.QWEN_TURBO)\n          .messages(Arrays.asList(\n              Message.builder()\n                  .role(Role.USER.getValue())\n                  .content(\"Hello, how are you?\").build()\n          )).build();\n\n      class ReactCallback extends ResultCallback\u003cGenerationResult\u003e {\n\n        @Override\n        public void onEvent(GenerationResult message) {\n          System.out.println( JsonUtils.toJson(message));\n          // TODO deal with result\n        }\n\n        public void onComplete() {\n          // TODO all messages received\n        }\n\n        public void onError(Exception e) {\n          ApiException apiException = (ApiException) e;\n          // TODO deal with exception\n        }\n      }\n\n      generation.call(param, new ReactCallback());\n    }\n}\n\n```\n\nThe Exception instance in the conversation scenario is a `ApiException` instance. This Exception may contain two parts:\n\n- A `Status` instance. This instance carries a status_code(The http error code), a code(server error code), a message(server error message), the input message id, and the usage information.\n- If an exception occurs, the `ApiException` instance may only carry an `Exception` stack trace, you can deal with it as you usually do.\n\n#### Stream only, accept by react io\n\n```java\nimport com.alibaba.dashscope.aigc.generation.Generation;\nimport com.alibaba.dashscope.aigc.generation.GenerationParam;\nimport com.alibaba.dashscope.aigc.generation.GenerationResult;\nimport com.alibaba.dashscope.common.Message;\nimport com.alibaba.dashscope.common.Role;\nimport com.alibaba.dashscope.exception.ApiException;\nimport com.alibaba.dashscope.exception.InputRequiredException;\nimport com.alibaba.dashscope.exception.NoApiKeyException;\nimport com.alibaba.dashscope.utils.JsonUtils;\nimport io.reactivex.Flowable;\nimport java.util.Arrays;\n\npublic class Main {\n\n  public static void main(String[] args) {\n    Generation generation = new Generation();\n\n    Message systemMsg = Message.builder()\n        .role(Role.SYSTEM.getValue())\n        .content(\"You are a helpful assistant.\")\n        .build();\n    Message userMsg = Message.builder()\n        .role(Role.USER.getValue())\n        .content(\"你是谁？\")\n        .build();\n    GenerationParam param = GenerationParam.builder()\n        .apiKey(System.getenv(\"DASHSCOPE_API_KEY\"))\n        .model(Generation.Models.QWEN_TURBO)\n        .messages(Arrays.asList(systemMsg, userMsg))\n        .resultFormat(GenerationParam.ResultFormat.MESSAGE)\n        .build();\n\n    try {\n      Flowable\u003cGenerationResult\u003e result = generation.streamCall( param);\n      result.blockingForEach(msg -\u003e System.out.println(JsonUtils.toJson(msg)));\n\n    } catch (ApiException | NoApiKeyException | InputRequiredException e) {\n      System.err.println(\"An error occurred while calling the generation service: \" + e.getMessage());\n    }\n  }\n}\n```\n\nThe `streamCall` method accepts a `GenerationParam` , and returns a `Flowable`, which you can get the streaming result by `blockingForEach`, and catch the exception by the try-catch block.\n\n#### Non-stream only\n\n```java\nimport com.alibaba.dashscope.aigc.generation.Generation;\nimport com.alibaba.dashscope.aigc.generation.GenerationParam;\nimport com.alibaba.dashscope.aigc.generation.GenerationResult;\nimport com.alibaba.dashscope.common.Message;\nimport com.alibaba.dashscope.common.Role;\nimport com.alibaba.dashscope.exception.ApiException;\nimport com.alibaba.dashscope.exception.InputRequiredException;\nimport com.alibaba.dashscope.exception.NoApiKeyException;\nimport com.alibaba.dashscope.utils.JsonUtils;\nimport java.util.Arrays;\n\npublic class Main {\n\n  public static void main(String[] args) {\n    Generation generation = new Generation();\n\n    Message systemMsg = Message.builder()\n        .role(Role.SYSTEM.getValue())\n        .content(\"You are a helpful assistant.\")\n        .build();\n    Message userMsg = Message.builder()\n        .role(Role.USER.getValue())\n        .content(\"你是谁？\")\n        .build();\n    GenerationParam param = GenerationParam.builder()\n        .apiKey(System.getenv(\"DASHSCOPE_API_KEY\"))\n        .model(Generation.Models.QWEN_TURBO)\n        .messages(Arrays.asList(systemMsg, userMsg))\n        .resultFormat(GenerationParam.ResultFormat.MESSAGE)\n        .build();\n\n    try {\n      GenerationResult result = generation.call( param);\n      System.out.println(JsonUtils.toJson(result));\n    } catch (ApiException | NoApiKeyException | InputRequiredException e) {\n      System.err.println(\"An error occurred while calling the generation service: \" + e.getMessage());\n    }\n  }\n}\n```\n\nThe `call` method accepts a `GenerationParam`, and returns a `GenerationResult`, you can also catch the exception with a try-catch block.\n","author":{"url":"https://github.com/XiaotianZha","@type":"Person","name":"XiaotianZha"},"datePublished":"2025-12-18T02:44:34.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/166/dashscope-sdk-java/issues/166"}