From 0af1a220e9ffa39d439d9d0e299c6997c6a81501 Mon Sep 17 00:00:00 2001 From: Daniel Lavoie Date: Sat, 28 Dec 2019 22:36:01 -0500 Subject: [PATCH] Initial Commit --- .gitignore | 3 + .mvn/wrapper/MavenWrapperDownloader.java | 117 +++++++ .mvn/wrapper/maven-wrapper.jar | Bin 0 -> 50710 bytes .mvn/wrapper/maven-wrapper.properties | 2 + LICENSE | 201 ++++++++++++ README.md | 84 +++++ client/.gitignore | 4 + client/pom.xml | 60 ++++ .../daniellavoie/ksqldb/client/AdminUtil.java | 83 +++++ .../ksqldb/client/ColumnDefinition.java | 42 +++ .../daniellavoie/ksqldb/client/DataType.java | 28 ++ .../ksqldb/client/DefaultKsqlDBClient.java | 211 ++++++++++++ .../daniellavoie/ksqldb/client/JsonUtil.java | 35 ++ .../ksqldb/client/KsqlDBClient.java | 167 ++++++++++ .../ksqldb/client/KsqlDBServerError.java | 80 +++++ .../ksqldb/client/KsqlDBServerException.java | 46 +++ .../ksqldb/client/ReactorWebClient.java | 175 ++++++++++ .../ksqldb/client/RowExtractor.java | 14 + .../ksqldb/client/URLEncoderUtil.java | 19 ++ .../ksqldb/client/ValueExtractor.java | 7 + .../ksqldb/client/ValueFormat.java | 5 + .../daniellavoie/ksqldb/client/WebClient.java | 72 ++++ .../ksqldb/client/api/info/Details.java | 46 +++ .../client/api/info/HealthcheckResponse.java | 46 +++ .../ksqldb/client/api/info/InfoResponse.java | 40 +++ .../ksqldb/client/api/info/Kafka.java | 40 +++ .../client/api/info/KsqlServerInfo.java | 54 +++ .../ksqldb/client/api/info/Metastore.java | 40 +++ .../client/api/ksql/CommandResponse.java | 52 +++ .../ksqldb/client/api/ksql/CommandStatus.java | 39 +++ .../client/api/ksql/DescribeResponse.java | 43 +++ .../client/api/ksql/ExplainResponse.java | 39 +++ .../ksqldb/client/api/ksql/Field.java | 39 +++ .../ksqldb/client/api/ksql/Format.java | 21 ++ .../ksqldb/client/api/ksql/KsqlRequest.java | 48 +++ .../ksqldb/client/api/ksql/KsqlResponse.java | 51 +++ .../ksqldb/client/api/ksql/Options.java | 37 +++ .../client/api/ksql/PropertiesResponse.java | 54 +++ .../client/api/ksql/QueriesResponse.java | 39 +++ .../ksqldb/client/api/ksql/Query.java | 48 +++ .../client/api/ksql/QueryDescription.java | 88 +++++ .../ksqldb/client/api/ksql/Schema.java | 48 +++ .../client/api/ksql/SourceDescription.java | 121 +++++++ .../ksqldb/client/api/ksql/Stream.java | 56 ++++ .../client/api/ksql/StreamsResponse.java | 38 +++ .../ksqldb/client/api/ksql/Table.java | 63 ++++ .../client/api/ksql/TablesResponse.java | 40 +++ .../ksqldb/client/api/ksql/Warning.java | 33 ++ .../ksqldb/client/api/query/QueryRequest.java | 48 +++ .../client/api/query/QueryResponse.java | 54 +++ .../ksqldb/client/api/query/Row.java | 42 +++ .../ksqldb/client/model/QueryRow.java | 43 +++ docker-compose.yml | 133 ++++++++ integration-tests/.gitignore | 4 + integration-tests/pom.xml | 53 +++ .../ksqldb/client/tests/EndpointTest.java | 151 +++++++++ .../tests/KsqlDBClientTestsApplication.java | 39 +++ .../ksqldb/client/tests/Transaction.java | 92 ++++++ .../ksqldb/client/tests/info/InfoTests.java | 59 ++++ .../ksqldb/client/tests/kafka/KafkaUtil.java | 44 +++ .../client/tests/ksql/DescribeTest.java | 60 ++++ .../ksqldb/client/tests/ksql/ExplainTest.java | 46 +++ .../client/tests/ksql/ShowPropertiesTest.java | 33 ++ .../client/tests/ksql/ShowStreamTest.java | 33 ++ .../client/tests/ksql/ShowTableTest.java | 33 ++ .../ksqldb/client/tests/query/QueryTest.java | 135 ++++++++ .../src/test/resources/application.properties | 10 + mvnw | 310 ++++++++++++++++++ mvnw.cmd | 182 ++++++++++ pom.xml | 84 +++++ samples/simple-client/.classpath | 38 +++ samples/simple-client/pom.xml | 21 ++ 72 files changed, 4465 insertions(+) create mode 100644 .gitignore create mode 100644 .mvn/wrapper/MavenWrapperDownloader.java create mode 100644 .mvn/wrapper/maven-wrapper.jar create mode 100644 .mvn/wrapper/maven-wrapper.properties create mode 100644 LICENSE create mode 100644 README.md create mode 100644 client/.gitignore create mode 100644 client/pom.xml create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/AdminUtil.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/ColumnDefinition.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/DataType.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/DefaultKsqlDBClient.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/JsonUtil.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBClient.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBServerError.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBServerException.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/ReactorWebClient.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/RowExtractor.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/URLEncoderUtil.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/ValueExtractor.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/ValueFormat.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/WebClient.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Details.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/HealthcheckResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/InfoResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Kafka.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/KsqlServerInfo.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Metastore.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/CommandResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/CommandStatus.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/DescribeResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/ExplainResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Field.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Format.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/KsqlRequest.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/KsqlResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Options.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/PropertiesResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/QueriesResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Query.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/QueryDescription.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Schema.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/SourceDescription.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Stream.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/StreamsResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Table.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/TablesResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Warning.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/QueryRequest.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/QueryResponse.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/Row.java create mode 100644 client/src/main/java/dev/daniellavoie/ksqldb/client/model/QueryRow.java create mode 100644 docker-compose.yml create mode 100644 integration-tests/.gitignore create mode 100644 integration-tests/pom.xml create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/EndpointTest.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/KsqlDBClientTestsApplication.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/Transaction.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/info/InfoTests.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/kafka/KafkaUtil.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/DescribeTest.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ExplainTest.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowPropertiesTest.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowStreamTest.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowTableTest.java create mode 100644 integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/query/QueryTest.java create mode 100644 integration-tests/src/test/resources/application.properties create mode 100755 mvnw create mode 100644 mvnw.cmd create mode 100644 pom.xml create mode 100644 samples/simple-client/.classpath create mode 100644 samples/simple-client/pom.xml diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..5ddaecd --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +.project +.settings +target diff --git a/.mvn/wrapper/MavenWrapperDownloader.java b/.mvn/wrapper/MavenWrapperDownloader.java new file mode 100644 index 0000000..b901097 --- /dev/null +++ b/.mvn/wrapper/MavenWrapperDownloader.java @@ -0,0 +1,117 @@ +/* + * Copyright 2007-present the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +import java.net.*; +import java.io.*; +import java.nio.channels.*; +import java.util.Properties; + +public class MavenWrapperDownloader { + + private static final String WRAPPER_VERSION = "0.5.6"; + /** + * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided. + */ + private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/" + + WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar"; + + /** + * Path to the maven-wrapper.properties file, which might contain a downloadUrl property to + * use instead of the default one. + */ + private static final String MAVEN_WRAPPER_PROPERTIES_PATH = + ".mvn/wrapper/maven-wrapper.properties"; + + /** + * Path where the maven-wrapper.jar will be saved to. + */ + private static final String MAVEN_WRAPPER_JAR_PATH = + ".mvn/wrapper/maven-wrapper.jar"; + + /** + * Name of the property which should be used to override the default download url for the wrapper. + */ + private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl"; + + public static void main(String args[]) { + System.out.println("- Downloader started"); + File baseDirectory = new File(args[0]); + System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath()); + + // If the maven-wrapper.properties exists, read it and check if it contains a custom + // wrapperUrl parameter. + File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH); + String url = DEFAULT_DOWNLOAD_URL; + if(mavenWrapperPropertyFile.exists()) { + FileInputStream mavenWrapperPropertyFileInputStream = null; + try { + mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile); + Properties mavenWrapperProperties = new Properties(); + mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream); + url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url); + } catch (IOException e) { + System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'"); + } finally { + try { + if(mavenWrapperPropertyFileInputStream != null) { + mavenWrapperPropertyFileInputStream.close(); + } + } catch (IOException e) { + // Ignore ... + } + } + } + System.out.println("- Downloading from: " + url); + + File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH); + if(!outputFile.getParentFile().exists()) { + if(!outputFile.getParentFile().mkdirs()) { + System.out.println( + "- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'"); + } + } + System.out.println("- Downloading to: " + outputFile.getAbsolutePath()); + try { + downloadFileFromURL(url, outputFile); + System.out.println("Done"); + System.exit(0); + } catch (Throwable e) { + System.out.println("- Error downloading"); + e.printStackTrace(); + System.exit(1); + } + } + + private static void downloadFileFromURL(String urlString, File destination) throws Exception { + if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) { + String username = System.getenv("MVNW_USERNAME"); + char[] password = System.getenv("MVNW_PASSWORD").toCharArray(); + Authenticator.setDefault(new Authenticator() { + @Override + protected PasswordAuthentication getPasswordAuthentication() { + return new PasswordAuthentication(username, password); + } + }); + } + URL website = new URL(urlString); + ReadableByteChannel rbc; + rbc = Channels.newChannel(website.openStream()); + FileOutputStream fos = new FileOutputStream(destination); + fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE); + fos.close(); + rbc.close(); + } + +} diff --git a/.mvn/wrapper/maven-wrapper.jar b/.mvn/wrapper/maven-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..2cc7d4a55c0cd0092912bf49ae38b3a9e3fd0054 GIT binary patch literal 50710 zcmbTd1CVCTmM+|7+wQV$+qP}n>auOywyU~q+qUhh+uxis_~*a##hm*_WW?9E7Pb7N%LRFiwbEGCJ0XP=%-6oeT$XZcYgtzC2~q zk(K08IQL8oTl}>>+hE5YRgXTB@fZ4TH9>7=79e`%%tw*SQUa9~$xKD5rS!;ZG@ocK zQdcH}JX?W|0_Afv?y`-NgLum62B&WSD$-w;O6G0Sm;SMX65z)l%m1e-g8Q$QTI;(Q z+x$xth4KFvH@Bs6(zn!iF#nenk^Y^ce;XIItAoCsow38eq?Y-Auh!1in#Rt-_D>H^ z=EjbclGGGa6VnaMGmMLj`x3NcwA43Jb(0gzl;RUIRAUDcR1~99l2SAPkVhoRMMtN} zXvC<tOmX83grD8GSo_Lo?%lNfhD#EBgPo z*nf@ppMC#B!T)Ae0RG$mlJWmGl7CkuU~B8-==5i;rS;8i6rJ=PoQxf446XDX9g|c> zU64ePyMlsI^V5Jq5A+BPe#e73+kpc_r1tv#B)~EZ;7^67F0*QiYfrk0uVW;Qb=NsG zN>gsuCwvb?s-KQIppEaeXtEMdc9dy6Dfduz-tMTms+i01{eD9JE&h?Kht*$eOl#&L zJdM_-vXs(V#$Ed;5wyNWJdPNh+Z$+;$|%qR(t`4W@kDhd*{(7-33BOS6L$UPDeE_53j${QfKN-0v-HG z(QfyvFNbwPK%^!eIo4ac1;b>c0vyf9}Xby@YY!lkz-UvNp zwj#Gg|4B~?n?G^{;(W;|{SNoJbHTMpQJ*Wq5b{l9c8(%?Kd^1?H1om1de0Da9M;Q=n zUfn{f87iVb^>Exl*nZ0hs(Yt>&V9$Pg`zX`AI%`+0SWQ4Zc(8lUDcTluS z5a_KerZWe}a-MF9#Cd^fi!y3%@RFmg&~YnYZ6<=L`UJ0v={zr)>$A;x#MCHZy1st7 ztT+N07NR+vOwSV2pvWuN1%lO!K#Pj0Fr>Q~R40{bwdL%u9i`DSM4RdtEH#cW)6}+I-eE< z&tZs+(Ogu(H_;$a$!7w`MH0r%h&@KM+<>gJL@O~2K2?VrSYUBbhCn#yy?P)uF3qWU z0o09mIik+kvzV6w>vEZy@&Mr)SgxPzUiDA&%07m17udz9usD82afQEps3$pe!7fUf z0eiidkJ)m3qhOjVHC_M(RYCBO%CZKZXFb8}s0-+}@CIn&EF(rRWUX2g^yZCvl0bI} zbP;1S)iXnRC&}5-Tl(hASKqdSnO?ASGJ*MIhOXIblmEudj(M|W!+I3eDc}7t`^mtg z)PKlaXe(OH+q-)qcQ8a@!llRrpGI8DsjhoKvw9T;TEH&?s=LH0w$EzI>%u;oD@x83 zJL7+ncjI9nn!TlS_KYu5vn%f*@qa5F;| zEFxY&B?g=IVlaF3XNm_03PA)=3|{n-UCgJoTr;|;1AU9|kPE_if8!Zvb}0q$5okF$ zHaJdmO&gg!9oN|M{!qGE=tb|3pVQ8PbL$}e;NgXz<6ZEggI}wO@aBP**2Wo=yN#ZC z4G$m^yaM9g=|&!^ft8jOLuzc3Psca*;7`;gnHm}tS0%f4{|VGEwu45KptfNmwxlE~ z^=r30gi@?cOm8kAz!EylA4G~7kbEiRlRIzwrb~{_2(x^$-?|#e6Bi_**(vyr_~9Of z!n>Gqf+Qwiu!xhi9f53=PM3`3tNF}pCOiPU|H4;pzjcsqbwg*{{kyrTxk<;mx~(;; z1NMrpaQ`57yn34>Jo3b|HROE(UNcQash!0p2-!Cz;{IRv#Vp5!3o$P8!%SgV~k&Hnqhp`5eLjTcy93cK!3Hm-$`@yGnaE=?;*2uSpiZTs_dDd51U%i z{|Zd9ou-;laGS_x=O}a+ zB||za<795A?_~Q=r=coQ+ZK@@ zId~hWQL<%)fI_WDIX#=(WNl!Dm$a&ROfLTd&B$vatq!M-2Jcs;N2vps$b6P1(N}=oI3<3luMTmC|0*{ zm1w8bt7vgX($!0@V0A}XIK)w!AzUn7vH=pZEp0RU0p?}ch2XC-7r#LK&vyc2=-#Q2 z^L%8)JbbcZ%g0Du;|8=q8B>X=mIQirpE=&Ox{TiuNDnOPd-FLI^KfEF729!!0x#Es z@>3ursjFSpu%C-8WL^Zw!7a0O-#cnf`HjI+AjVCFitK}GXO`ME&on|^=~Zc}^LBp9 zj=-vlN;Uc;IDjtK38l7}5xxQF&sRtfn4^TNtnzXv4M{r&ek*(eNbIu!u$>Ed%` z5x7+&)2P&4>0J`N&ZP8$vcR+@FS0126s6+Jx_{{`3ZrIMwaJo6jdrRwE$>IU_JTZ} z(||hyyQ)4Z1@wSlT94(-QKqkAatMmkT7pCycEB1U8KQbFX&?%|4$yyxCtm3=W`$4fiG0WU3yI@c zx{wfmkZAYE_5M%4{J-ygbpH|(|GD$2f$3o_Vti#&zfSGZMQ5_f3xt6~+{RX=$H8at z?GFG1Tmp}}lmm-R->ve*Iv+XJ@58p|1_jRvfEgz$XozU8#iJS})UM6VNI!3RUU!{5 zXB(+Eqd-E;cHQ>)`h0(HO_zLmzR3Tu-UGp;08YntWwMY-9i^w_u#wR?JxR2bky5j9 z3Sl-dQQU$xrO0xa&>vsiK`QN<$Yd%YXXM7*WOhnRdSFt5$aJux8QceC?lA0_if|s> ze{ad*opH_kb%M&~(~&UcX0nFGq^MqjxW?HJIP462v9XG>j(5Gat_)#SiNfahq2Mz2 zU`4uV8m$S~o9(W>mu*=h%Gs(Wz+%>h;R9Sg)jZ$q8vT1HxX3iQnh6&2rJ1u|j>^Qf`A76K%_ubL`Zu?h4`b=IyL>1!=*%!_K)=XC z6d}4R5L+sI50Q4P3upXQ3Z!~1ZXLlh!^UNcK6#QpYt-YC=^H=EPg3)z*wXo*024Q4b2sBCG4I# zlTFFY=kQ>xvR+LsuDUAk)q%5pEcqr(O_|^spjhtpb1#aC& zghXzGkGDC_XDa%t(X`E+kvKQ4zrQ*uuQoj>7@@ykWvF332)RO?%AA&Fsn&MNzmFa$ zWk&&^=NNjxLjrli_8ESU)}U|N{%j&TQmvY~lk!~Jh}*=^INA~&QB9em!in_X%Rl1&Kd~Z(u z9mra#<@vZQlOY+JYUwCrgoea4C8^(xv4ceCXcejq84TQ#sF~IU2V}LKc~Xlr_P=ry zl&Hh0exdCbVd^NPCqNNlxM3vA13EI8XvZ1H9#bT7y*U8Y{H8nwGpOR!e!!}*g;mJ#}T{ekSb}5zIPmye*If(}}_=PcuAW#yidAa^9-`<8Gr0 z)Fz=NiZ{)HAvw{Pl5uu)?)&i&Us$Cx4gE}cIJ}B4Xz~-q7)R_%owbP!z_V2=Aq%Rj z{V;7#kV1dNT9-6R+H}}(ED*_!F=~uz>&nR3gb^Ce%+0s#u|vWl<~JD3MvS0T9thdF zioIG3c#Sdsv;LdtRv3ml7%o$6LTVL>(H`^@TNg`2KPIk*8-IB}X!MT0`hN9Ddf7yN z?J=GxPL!uJ7lqwowsl?iRrh@#5C$%E&h~Z>XQcvFC*5%0RN-Opq|=IwX(dq(*sjs+ zqy99+v~m|6T#zR*e1AVxZ8djd5>eIeCi(b8sUk)OGjAsKSOg^-ugwl2WSL@d#?mdl zib0v*{u-?cq}dDGyZ%$XRY=UkQwt2oGu`zQneZh$=^! zj;!pCBWQNtvAcwcWIBM2y9!*W|8LmQy$H~5BEx)78J`4Z0(FJO2P^!YyQU{*Al+fs z){!4JvT1iLrJ8aU3k0t|P}{RN)_^v%$$r;+p0DY7N8CXzmS*HB*=?qaaF9D@#_$SN zSz{moAK<*RH->%r7xX~9gVW$l7?b|_SYI)gcjf0VAUJ%FcQP(TpBs; zg$25D!Ry_`8xpS_OJdeo$qh#7U+cepZ??TII7_%AXsT$B z=e)Bx#v%J0j``00Zk5hsvv6%T^*xGNx%KN-=pocSoqE5_R)OK%-Pbu^1MNzfds)mL zxz^F4lDKV9D&lEY;I+A)ui{TznB*CE$=9(wgE{m}`^<--OzV-5V4X2w9j(_!+jpTr zJvD*y6;39&T+==$F&tsRKM_lqa1HC}aGL0o`%c9mO=fts?36@8MGm7Vi{Y z^<7m$(EtdSr#22<(rm_(l_(`j!*Pu~Y>>xc>I9M#DJYDJNHO&4=HM%YLIp?;iR&$m z#_$ZWYLfGLt5FJZhr3jpYb`*%9S!zCG6ivNHYzNHcI%khtgHBliM^Ou}ZVD7ehU9 zS+W@AV=?Ro!=%AJ>Kcy9aU3%VX3|XM_K0A+ZaknKDyIS3S-Hw1C7&BSW5)sqj5Ye_ z4OSW7Yu-;bCyYKHFUk}<*<(@TH?YZPHr~~Iy%9@GR2Yd}J2!N9K&CN7Eq{Ka!jdu; zQNB*Y;i(7)OxZK%IHGt#Rt?z`I|A{q_BmoF!f^G}XVeTbe1Wnzh%1g>j}>DqFf;Rp zz7>xIs12@Ke0gr+4-!pmFP84vCIaTjqFNg{V`5}Rdt~xE^I;Bxp4)|cs8=f)1YwHz zqI`G~s2~qqDV+h02b`PQpUE#^^Aq8l%y2|ByQeXSADg5*qMprEAE3WFg0Q39`O+i1 z!J@iV!`Y~C$wJ!5Z+j5$i<1`+@)tBG$JL=!*uk=2k;T<@{|s1$YL079FvK%mPhyHV zP8^KGZnp`(hVMZ;s=n~3r2y;LTwcJwoBW-(ndU-$03{RD zh+Qn$ja_Z^OuMf3Ub|JTY74s&Am*(n{J3~@#OJNYuEVVJd9*H%)oFoRBkySGm`hx! zT3tG|+aAkXcx-2Apy)h^BkOyFTWQVeZ%e2@;*0DtlG9I3Et=PKaPt&K zw?WI7S;P)TWED7aSH$3hL@Qde?H#tzo^<(o_sv_2ci<7M?F$|oCFWc?7@KBj-;N$P zB;q!8@bW-WJY9do&y|6~mEruZAVe$!?{)N9rZZxD-|oltkhW9~nR8bLBGXw<632!l z*TYQn^NnUy%Ds}$f^=yQ+BM-a5X4^GHF=%PDrRfm_uqC zh{sKwIu|O0&jWb27;wzg4w5uA@TO_j(1X?8E>5Zfma|Ly7Bklq|s z9)H`zoAGY3n-+&JPrT!>u^qg9Evx4y@GI4$n-Uk_5wttU1_t?6><>}cZ-U+&+~JE) zPlDbO_j;MoxdLzMd~Ew|1o^a5q_1R*JZ=#XXMzg?6Zy!^hop}qoLQlJ{(%!KYt`MK z8umEN@Z4w!2=q_oe=;QttPCQy3Nm4F@x>@v4sz_jo{4m*0r%J(w1cSo;D_hQtJs7W z><$QrmG^+<$4{d2bgGo&3-FV}avg9zI|Rr(k{wTyl3!M1q+a zD9W{pCd%il*j&Ft z5H$nENf>>k$;SONGW`qo6`&qKs*T z2^RS)pXk9b@(_Fw1bkb)-oqK|v}r$L!W&aXA>IpcdNZ_vWE#XO8X`#Yp1+?RshVcd zknG%rPd*4ECEI0wD#@d+3NbHKxl}n^Sgkx==Iu%}HvNliOqVBqG?P2va zQ;kRJ$J6j;+wP9cS za#m;#GUT!qAV%+rdWolk+)6kkz4@Yh5LXP+LSvo9_T+MmiaP-eq6_k;)i6_@WSJ zlT@wK$zqHu<83U2V*yJ|XJU4farT#pAA&@qu)(PO^8PxEmPD4;Txpio+2)#!9 z>&=i7*#tc0`?!==vk>s7V+PL#S1;PwSY?NIXN2=Gu89x(cToFm))7L;< z+bhAbVD*bD=}iU`+PU+SBobTQ%S!=VL!>q$rfWsaaV}Smz>lO9JXT#`CcH_mRCSf4%YQAw`$^yY z3Y*^Nzk_g$xn7a_NO(2Eb*I=^;4f!Ra#Oo~LLjlcjke*k*o$~U#0ZXOQ5@HQ&T46l z7504MUgZkz2gNP1QFN8Y?nSEnEai^Rgyvl}xZfMUV6QrJcXp;jKGqB=D*tj{8(_pV zqyB*DK$2lgYGejmJUW)*s_Cv65sFf&pb(Yz8oWgDtQ0~k^0-wdF|tj}MOXaN@ydF8 zNr={U?=;&Z?wr^VC+`)S2xl}QFagy;$mG=TUs7Vi2wws5zEke4hTa2)>O0U?$WYsZ z<8bN2bB_N4AWd%+kncgknZ&}bM~eDtj#C5uRkp21hWW5gxWvc6b*4+dn<{c?w9Rmf zIVZKsPl{W2vQAlYO3yh}-{Os=YBnL8?uN5(RqfQ=-1cOiUnJu>KcLA*tQK3FU`_bM zM^T28w;nAj5EdAXFi&Kk1Nnl2)D!M{@+D-}bIEe+Lc4{s;YJc-{F#``iS2uk;2!Zp zF9#myUmO!wCeJIoi^A+T^e~20c+c2C}XltaR!|U-HfDA=^xF97ev}$l6#oY z&-&T{egB)&aV$3_aVA51XGiU07$s9vubh_kQG?F$FycvS6|IO!6q zq^>9|3U^*!X_C~SxX&pqUkUjz%!j=VlXDo$!2VLH!rKj@61mDpSr~7B2yy{>X~_nc zRI+7g2V&k zd**H++P9dg!-AOs3;GM`(g<+GRV$+&DdMVpUxY9I1@uK28$az=6oaa+PutlO9?6#? zf-OsgT>^@8KK>ggkUQRPPgC7zjKFR5spqQb3ojCHzj^(UH~v+!y*`Smv)VpVoPwa6 zWG18WJaPKMi*F6Zdk*kU^`i~NNTfn3BkJniC`yN98L-Awd)Z&mY? zprBW$!qL-OL7h@O#kvYnLsfff@kDIegt~?{-*5A7JrA;#TmTe?jICJqhub-G@e??D zqiV#g{)M!kW1-4SDel7TO{;@*h2=_76g3NUD@|c*WO#>MfYq6_YVUP+&8e4|%4T`w zXzhmVNziAHazWO2qXcaOu@R1MrPP{t)`N)}-1&~mq=ZH=w=;-E$IOk=y$dOls{6sRR`I5>|X zpq~XYW4sd;J^6OwOf**J>a7u$S>WTFPRkjY;BfVgQst)u4aMLR1|6%)CB^18XCz+r ztkYQ}G43j~Q&1em(_EkMv0|WEiKu;z2zhb(L%$F&xWwzOmk;VLBYAZ8lOCziNoPw1 zv2BOyXA`A8z^WH!nXhKXM`t0;6D*-uGds3TYGrm8SPnJJOQ^fJU#}@aIy@MYWz**H zvkp?7I5PE{$$|~{-ZaFxr6ZolP^nL##mHOErB^AqJqn^hFA=)HWj!m3WDaHW$C)i^ z9@6G$SzB=>jbe>4kqr#sF7#K}W*Cg-5y6kun3u&0L7BpXF9=#7IN8FOjWrWwUBZiU zT_se3ih-GBKx+Uw0N|CwP3D@-C=5(9T#BH@M`F2!Goiqx+Js5xC92|Sy0%WWWp={$(am!#l~f^W_oz78HX<0X#7 zp)p1u~M*o9W@O8P{0Qkg@Wa# z2{Heb&oX^CQSZWSFBXKOfE|tsAm#^U-WkDnU;IowZ`Ok4!mwHwH=s|AqZ^YD4!5!@ zPxJj+Bd-q6w_YG`z_+r;S86zwXb+EO&qogOq8h-Ect5(M2+>(O7n7)^dP*ws_3U6v zVsh)sk^@*c>)3EML|0<-YROho{lz@Nd4;R9gL{9|64xVL`n!m$-Jjrx?-Bacp!=^5 z1^T^eB{_)Y<9)y{-4Rz@9_>;_7h;5D+@QcbF4Wv7hu)s0&==&6u)33 zHRj+&Woq-vDvjwJCYES@$C4{$?f$Ibi4G()UeN11rgjF+^;YE^5nYprYoJNoudNj= zm1pXSeG64dcWHObUetodRn1Fw|1nI$D9z}dVEYT0lQnsf_E1x2vBLql7NrHH!n&Sq z6lc*mvU=WS6=v9Lrl}&zRiu_6u;6g%_DU{9b+R z#YHqX7`m9eydf?KlKu6Sb%j$%_jmydig`B*TN`cZL-g!R)iE?+Q5oOqBFKhx z%MW>BC^(F_JuG(ayE(MT{S3eI{cKiwOtPwLc0XO*{*|(JOx;uQOfq@lp_^cZo=FZj z4#}@e@dJ>Bn%2`2_WPeSN7si^{U#H=7N4o%Dq3NdGybrZgEU$oSm$hC)uNDC_M9xc zGzwh5Sg?mpBIE8lT2XsqTt3j3?We8}3bzLBTQd639vyg^$0#1epq8snlDJP2(BF)K zSx30RM+{f+b$g{9usIL8H!hCO117Xgv}ttPJm9wVRjPk;ePH@zxv%j9k5`TzdXLeT zFgFX`V7cYIcBls5WN0Pf6SMBN+;CrQ(|EsFd*xtwr#$R{Z9FP`OWtyNsq#mCgZ7+P z^Yn$haBJ)r96{ZJd8vlMl?IBxrgh=fdq_NF!1{jARCVz>jNdC)H^wfy?R94#MPdUjcYX>#wEx+LB#P-#4S-%YH>t-j+w zOFTI8gX$ard6fAh&g=u&56%3^-6E2tpk*wx3HSCQ+t7+*iOs zPk5ysqE}i*cQocFvA68xHfL|iX(C4h*67@3|5Qwle(8wT&!&{8*{f%0(5gH+m>$tq zp;AqrP7?XTEooYG1Dzfxc>W%*CyL16q|fQ0_jp%%Bk^k!i#Nbi(N9&T>#M{gez_Ws zYK=l}adalV(nH}I_!hNeb;tQFk3BHX7N}}R8%pek^E`X}%ou=cx8InPU1EE0|Hen- zyw8MoJqB5=)Z%JXlrdTXAE)eqLAdVE-=>wGHrkRet}>3Yu^lt$Kzu%$3#(ioY}@Gu zjk3BZuQH&~7H+C*uX^4}F*|P89JX;Hg2U!pt>rDi(n(Qe-c}tzb0#6_ItoR0->LSt zR~UT<-|@TO%O`M+_e_J4wx7^)5_%%u+J=yF_S#2Xd?C;Ss3N7KY^#-vx+|;bJX&8r zD?|MetfhdC;^2WG`7MCgs>TKKN=^=!x&Q~BzmQio_^l~LboTNT=I zC5pme^P@ER``p$2md9>4!K#vV-Fc1an7pl>_|&>aqP}+zqR?+~Z;f2^`a+-!Te%V? z;H2SbF>jP^GE(R1@%C==XQ@J=G9lKX+Z<@5}PO(EYkJh=GCv#)Nj{DkWJM2}F&oAZ6xu8&g7pn1ps2U5srwQ7CAK zN&*~@t{`31lUf`O;2w^)M3B@o)_mbRu{-`PrfNpF!R^q>yTR&ETS7^-b2*{-tZAZz zw@q5x9B5V8Qd7dZ!Ai$9hk%Q!wqbE1F1c96&zwBBaRW}(^axoPpN^4Aw}&a5dMe+*Gomky_l^54*rzXro$ z>LL)U5Ry>~FJi=*{JDc)_**c)-&faPz`6v`YU3HQa}pLtb5K)u%K+BOqXP0)rj5Au$zB zW1?vr?mDv7Fsxtsr+S6ucp2l#(4dnr9sD*v+@*>g#M4b|U?~s93>Pg{{a5|rm2xfI z`>E}?9S@|IoUX{Q1zjm5YJT|3S>&09D}|2~BiMo=z4YEjXlWh)V&qs;*C{`UMxp$9 zX)QB?G$fPD6z5_pNs>Jeh{^&U^)Wbr?2D6-q?)`*1k@!UvwQgl8eG$r+)NnFoT)L6 zg7lEh+E6J17krfYJCSjWzm67hEth24pomhz71|Qodn#oAILN)*Vwu2qpJirG)4Wnv}9GWOFrQg%Je+gNrPl8mw7ykE8{ z=|B4+uwC&bpp%eFcRU6{mxRV32VeH8XxX>v$du<$(DfinaaWxP<+Y97Z#n#U~V zVEu-GoPD=9$}P;xv+S~Ob#mmi$JQmE;Iz4(){y*9pFyW-jjgdk#oG$fl4o9E8bo|L zWjo4l%n51@Kz-n%zeSCD`uB?T%FVk+KBI}=ve zvlcS#wt`U6wrJo}6I6Rwb=1GzZfwE=I&Ne@p7*pH84XShXYJRgvK)UjQL%R9Zbm(m zxzTQsLTON$WO7vM)*vl%Pc0JH7WhP;$z@j=y#avW4X8iqy6mEYr@-}PW?H)xfP6fQ z&tI$F{NNct4rRMSHhaelo<5kTYq+(?pY)Ieh8*sa83EQfMrFupMM@nfEV@EmdHUv9 z35uzIrIuo4#WnF^_jcpC@uNNaYTQ~uZWOE6P@LFT^1@$o&q+9Qr8YR+ObBkpP9=F+$s5+B!mX2~T zAuQ6RenX?O{IlLMl1%)OK{S7oL}X%;!XUxU~xJN8xk z`xywS*naF(J#?vOpB(K=o~lE;m$zhgPWDB@=p#dQIW>xe_p1OLoWInJRKbEuoncf; zmS1!u-ycc1qWnDg5Nk2D)BY%jmOwCLC+Ny>`f&UxFowIsHnOXfR^S;&F(KXd{ODlm z$6#1ccqt-HIH9)|@fHnrKudu!6B$_R{fbCIkSIb#aUN|3RM>zuO>dpMbROZ`^hvS@ z$FU-;e4W}!ubzKrU@R*dW*($tFZ>}dd*4_mv)#O>X{U@zSzQt*83l9mI zI$8O<5AIDx`wo0}f2fsPC_l>ONx_`E7kdXu{YIZbp1$(^oBAH({T~&oQ&1{X951QW zmhHUxd)t%GQ9#ak5fTjk-cahWC;>^Rg7(`TVlvy0W@Y!Jc%QL3Ozu# zDPIqBCy&T2PWBj+d-JA-pxZlM=9ja2ce|3B(^VCF+a*MMp`(rH>Rt6W1$;r{n1(VK zLs>UtkT43LR2G$AOYHVailiqk7naz2yZGLo*xQs!T9VN5Q>eE(w zw$4&)&6xIV$IO^>1N-jrEUg>O8G4^@y+-hQv6@OmF@gy^nL_n1P1-Rtyy$Bl;|VcV zF=p*&41-qI5gG9UhKmmnjs932!6hceXa#-qfK;3d*a{)BrwNFeKU|ge?N!;zk+kB! zMD_uHJR#%b54c2tr~uGPLTRLg$`fupo}cRJeTwK;~}A>(Acy4k-Xk&Aa1&eWYS1ULWUj@fhBiWY$pdfy+F z@G{OG{*v*mYtH3OdUjwEr6%_ZPZ3P{@rfbNPQG!BZ7lRyC^xlMpWH`@YRar`tr}d> z#wz87t?#2FsH-jM6m{U=gp6WPrZ%*w0bFm(T#7m#v^;f%Z!kCeB5oiF`W33W5Srdt zdU?YeOdPG@98H7NpI{(uN{FJdu14r(URPH^F6tOpXuhU7T9a{3G3_#Ldfx_nT(Hec zo<1dyhsVsTw;ZkVcJ_0-h-T3G1W@q)_Q30LNv)W?FbMH+XJ* zy=$@39Op|kZv`Rt>X`zg&at(?PO^I=X8d9&myFEx#S`dYTg1W+iE?vt#b47QwoHI9 zNP+|3WjtXo{u}VG(lLUaW0&@yD|O?4TS4dfJI`HC-^q;M(b3r2;7|FONXphw-%7~* z&;2!X17|05+kZOpQ3~3!Nb>O94b&ZSs%p)TK)n3m=4eiblVtSx@KNFgBY_xV6ts;NF;GcGxMP8OKV^h6LmSb2E#Qnw ze!6Mnz7>lE9u{AgQ~8u2zM8CYD5US8dMDX-5iMlgpE9m*s+Lh~A#P1er*rF}GHV3h z=`STo?kIXw8I<`W0^*@mB1$}pj60R{aJ7>C2m=oghKyxMbFNq#EVLgP0cH3q7H z%0?L93-z6|+jiN|@v>ix?tRBU(v-4RV`}cQH*fp|)vd3)8i9hJ3hkuh^8dz{F5-~_ zUUr1T3cP%cCaTooM8dj|4*M=e6flH0&8ve32Q)0dyisl))XkZ7Wg~N}6y`+Qi2l+e zUd#F!nJp{#KIjbQdI`%oZ`?h=5G^kZ_uN`<(`3;a!~EMsWV|j-o>c?x#;zR2ktiB! z);5rrHl?GPtr6-o!tYd|uK;Vbsp4P{v_4??=^a>>U4_aUXPWQ$FPLE4PK$T^3Gkf$ zHo&9$U&G`d(Os6xt1r?sg14n)G8HNyWa^q8#nf0lbr4A-Fi;q6t-`pAx1T*$eKM*$ z|CX|gDrk#&1}>5H+`EjV$9Bm)Njw&7-ZR{1!CJTaXuP!$Pcg69`{w5BRHysB$(tWUes@@6aM69kb|Lx$%BRY^-o6bjH#0!7b;5~{6J+jKxU!Kmi# zndh@+?}WKSRY2gZ?Q`{(Uj|kb1%VWmRryOH0T)f3cKtG4oIF=F7RaRnH0Rc_&372={_3lRNsr95%ZO{IX{p@YJ^EI%+gvvKes5cY+PE@unghjdY5#9A!G z70u6}?zmd?v+{`vCu-53_v5@z)X{oPC@P)iA3jK$`r zSA2a7&!^zmUiZ82R2=1cumBQwOJUPz5Ay`RLfY(EiwKkrx%@YN^^XuET;tE zmr-6~I7j!R!KrHu5CWGSChO6deaLWa*9LLJbcAJsFd%Dy>a!>J`N)Z&oiU4OEP-!Ti^_!p}O?7`}i7Lsf$-gBkuY*`Zb z7=!nTT;5z$_5$=J=Ko+Cp|Q0J=%oFr>hBgnL3!tvFoLNhf#D0O=X^h+x08iB;@8pXdRHxX}6R4k@i6%vmsQwu^5z zk1ip`#^N)^#Lg#HOW3sPI33xqFB4#bOPVnY%d6prwxf;Y-w9{ky4{O6&94Ra8VN@K zb-lY;&`HtxW@sF!doT5T$2&lIvJpbKGMuDAFM#!QPXW87>}=Q4J3JeXlwHys?!1^#37q_k?N@+u&Ns20pEoBeZC*np;i;M{2C0Z4_br2gsh6eL z#8`#sn41+$iD?^GL%5?cbRcaa-Nx0vE(D=*WY%rXy3B%gNz0l?#noGJGP728RMY#q z=2&aJf@DcR?QbMmN)ItUe+VM_U!ryqA@1VVt$^*xYt~-qvW!J4Tp<-3>jT=7Zow5M z8mSKp0v4b%a8bxFr>3MwZHSWD73D@+$5?nZAqGM#>H@`)mIeC#->B)P8T$zh-Pxnc z8)~Zx?TWF4(YfKuF3WN_ckpCe5;x4V4AA3(i$pm|78{%!q?|~*eH0f=?j6i)n~Hso zmTo>vqEtB)`%hP55INf7HM@taH)v`Fw40Ayc*R!T?O{ziUpYmP)AH`euTK!zg9*6Z z!>M=$3pd0!&TzU=hc_@@^Yd3eUQpX4-33}b{?~5t5lgW=ldJ@dUAH%`l5US1y_`40 zs(X`Qk}vvMDYYq+@Rm+~IyCX;iD~pMgq^KY)T*aBz@DYEB={PxA>)mI6tM*sx-DmGQHEaHwRrAmNjO!ZLHO4b;;5mf@zzlPhkP($JeZGE7 z?^XN}Gf_feGoG~BjUgVa*)O`>lX=$BSR2)uD<9 z>o^|nb1^oVDhQbfW>>!;8-7<}nL6L^V*4pB=>wwW+RXAeRvKED(n1;R`A6v$6gy0I(;Vf?!4;&sgn7F%LpM}6PQ?0%2Z@b{It<(G1CZ|>913E0nR2r^Pa*Bp z@tFGi*CQ~@Yc-?{cwu1 zsilf=k^+Qs>&WZG(3WDixisHpR>`+ihiRwkL(3T|=xsoNP*@XX3BU8hr57l3k;pni zI``=3Nl4xh4oDj<%>Q1zYXHr%Xg_xrK3Nq?vKX3|^Hb(Bj+lONTz>4yhU-UdXt2>j z<>S4NB&!iE+ao{0Tx^N*^|EZU;0kJkx@zh}S^P{ieQjGl468CbC`SWnwLRYYiStXm zOxt~Rb3D{dz=nHMcY)#r^kF8|q8KZHVb9FCX2m^X*(|L9FZg!5a7((!J8%MjT$#Fs)M1Pb zq6hBGp%O1A+&%2>l0mpaIzbo&jc^!oN^3zxap3V2dNj3x<=TwZ&0eKX5PIso9j1;e zwUg+C&}FJ`k(M|%%}p=6RPUq4sT3-Y;k-<68ciZ~_j|bt>&9ZLHNVrp#+pk}XvM{8 z`?k}o-!if>hVlCP9j%&WI2V`5SW)BCeR5>MQhF)po=p~AYN%cNa_BbV6EEh_kk^@a zD>4&>uCGCUmyA-c)%DIcF4R6!>?6T~Mj_m{Hpq`*(wj>foHL;;%;?(((YOxGt)Bhx zuS+K{{CUsaC++%}S6~CJ=|vr(iIs-je)e9uJEU8ZJAz)w166q)R^2XI?@E2vUQ!R% zn@dxS!JcOimXkWJBz8Y?2JKQr>`~SmE2F2SL38$SyR1^yqj8_mkBp)o$@+3BQ~Mid z9U$XVqxX3P=XCKj0*W>}L0~Em`(vG<>srF8+*kPrw z20{z(=^w+ybdGe~Oo_i|hYJ@kZl*(9sHw#Chi&OIc?w`nBODp?ia$uF%Hs(X>xm?j zqZQ`Ybf@g#wli`!-al~3GWiE$K+LCe=Ndi!#CVjzUZ z!sD2O*;d28zkl))m)YN7HDi^z5IuNo3^w(zy8 zszJG#mp#Cj)Q@E@r-=NP2FVxxEAeOI2e=|KshybNB6HgE^(r>HD{*}S}mO>LuRGJT{*tfTzw_#+er-0${}%YPe@CMJ1Ng#j#)i)SnY@ss3gL;g zg2D~#Kpdfu#G;q1qz_TwSz1VJT(b3zby$Vk&;Y#1(A)|xj`_?i5YQ;TR%jice5E;0 zYHg;`zS5{S*9xI6o^j>rE8Ua*XhIw{_-*&@(R|C(am8__>+Ws&Q^ymy*X4~hR2b5r zm^p3sw}yv=tdyncy_Ui7{BQS732et~Z_@{-IhHDXAV`(Wlay<#hb>%H%WDi+K$862nA@BDtM#UCKMu+kM`!JHyWSi?&)A7_ z3{cyNG%a~nnH_!+;g&JxEMAmh-Z}rC!o7>OVzW&PoMyTA_g{hqXG)SLraA^OP**<7 zjWbr7z!o2n3hnx7A=2O=WL;`@9N{vQIM@&|G-ljrPvIuJHYtss0Er0fT5cMXNUf1B z7FAwBDixt0X7C3S)mPe5g`YtME23wAnbU)+AtV}z+e8G;0BP=bI;?(#|Ep!vVfDbK zvx+|CKF>yt0hWQ3drchU#XBU+HiuG*V^snFAPUp-5<#R&BUAzoB!aZ+e*KIxa26V}s6?nBK(U-7REa573wg-jqCg>H8~>O{ z*C0JL-?X-k_y%hpUFL?I>0WV{oV`Nb)nZbJG01R~AG>flIJf)3O*oB2i8~;!P?Wo_ z0|QEB*fifiL6E6%>tlAYHm2cjTFE@*<);#>689Z6S#BySQ@VTMhf9vYQyLeDg1*F} zjq>i1*x>5|CGKN{l9br3kB0EHY|k4{%^t7-uhjd#NVipUZa=EUuE5kS1_~qYX?>hJ z$}!jc9$O$>J&wnu0SgfYods^z?J4X;X7c77Me0kS-dO_VUQ39T(Kv(Y#s}Qqz-0AH z^?WRL(4RzpkD+T5FG_0NyPq-a-B7A5LHOCqwObRJi&oRi(<;OuIN7SV5PeHU$<@Zh zPozEV`dYmu0Z&Tqd>t>8JVde9#Pt+l95iHe$4Xwfy1AhI zDM4XJ;bBTTvRFtW>E+GzkN)9k!hA5z;xUOL2 zq4}zn-DP{qc^i|Y%rvi|^5k-*8;JZ~9a;>-+q_EOX+p1Wz;>i7c}M6Nv`^NY&{J-> z`(mzDJDM}QPu5i44**2Qbo(XzZ-ZDu%6vm8w@DUarqXj41VqP~ zs&4Y8F^Waik3y1fQo`bVUH;b=!^QrWb)3Gl=QVKr+6sxc=ygauUG|cm?|X=;Q)kQ8 zM(xrICifa2p``I7>g2R~?a{hmw@{!NS5`VhH8+;cV(F>B94M*S;5#O`YzZH1Z%yD? zZ61w(M`#aS-*~Fj;x|J!KM|^o;MI#Xkh0ULJcA?o4u~f%Z^16ViA27FxU5GM*rKq( z7cS~MrZ=f>_OWx8j#-Q3%!aEU2hVuTu(7`TQk-Bi6*!<}0WQi;_FpO;fhpL4`DcWp zGOw9vx0N~6#}lz(r+dxIGZM3ah-8qrqMmeRh%{z@dbUD2w15*_4P?I~UZr^anP}DB zU9CCrNiy9I3~d#&!$DX9e?A});BjBtQ7oGAyoI$8YQrkLBIH@2;lt4E^)|d6Jwj}z z&2_E}Y;H#6I4<10d_&P0{4|EUacwFHauvrjAnAm6yeR#}f}Rk27CN)vhgRqEyPMMS7zvunj2?`f;%?alsJ+-K+IzjJx>h8 zu~m_y$!J5RWAh|C<6+uiCNsOKu)E72M3xKK(a9Okw3e_*O&}7llNV!=P87VM2DkAk zci!YXS2&=P0}Hx|wwSc9JP%m8dMJA*q&VFB0yMI@5vWoAGraygwn){R+Cj6B1a2Px z5)u(K5{+;z2n*_XD!+Auv#LJEM)(~Hx{$Yb^ldQmcYF2zNH1V30*)CN_|1$v2|`LnFUT$%-tO0Eg|c5$BB~yDfzS zcOXJ$wpzVK0MfTjBJ0b$r#_OvAJ3WRt+YOLlJPYMx~qp>^$$$h#bc|`g0pF-Ao43? z>*A+8lx>}L{p(Tni2Vvk)dtzg$hUKjSjXRagj)$h#8=KV>5s)J4vGtRn5kP|AXIz! zPgbbVxW{2o4s-UM;c#We8P&mPN|DW7_uLF!a|^0S=wr6Esx9Z$2|c1?GaupU6$tb| zY_KU`(_29O_%k(;>^|6*pZURH3`@%EuKS;Ns z1lujmf;r{qAN&Q0&m{wJSZ8MeE7RM5+Sq;ul_ z`+ADrd_Um+G37js6tKsArNB}n{p*zTUxQr>3@wA;{EUbjNjlNd6$Mx zg0|MyU)v`sa~tEY5$en7^PkC=S<2@!nEdG6L=h(vT__0F=S8Y&eM=hal#7eM(o^Lu z2?^;05&|CNliYrq6gUv;|i!(W{0N)LWd*@{2q*u)}u*> z7MQgk6t9OqqXMln?zoMAJcc zMKaof_Up})q#DzdF?w^%tTI7STI^@8=Wk#enR*)&%8yje>+tKvUYbW8UAPg55xb70 zEn5&Ba~NmOJlgI#iS8W3-@N%>V!#z-ZRwfPO1)dQdQkaHsiqG|~we2ALqG7Ruup(DqSOft2RFg_X%3w?6VqvV1uzX_@F(diNVp z4{I|}35=11u$;?|JFBEE*gb;T`dy+8gWJ9~pNsecrO`t#V9jW-6mnfO@ff9od}b(3s4>p0i30gbGIv~1@a^F2kl7YO;DxmF3? zWi-RoXhzRJV0&XE@ACc?+@6?)LQ2XNm4KfalMtsc%4!Fn0rl zpHTrHwR>t>7W?t!Yc{*-^xN%9P0cs0kr=`?bQ5T*oOo&VRRu+1chM!qj%2I!@+1XF z4GWJ=7ix9;Wa@xoZ0RP`NCWw0*8247Y4jIZ>GEW7zuoCFXl6xIvz$ezsWgKdVMBH> z{o!A7f;R-@eK9Vj7R40xx)T<2$?F2E<>Jy3F;;=Yt}WE59J!1WN367 zA^6pu_zLoZIf*x031CcwotS{L8bJE(<_F%j_KJ2P_IusaZXwN$&^t716W{M6X2r_~ zaiMwdISX7Y&Qi&Uh0upS3TyEIXNDICQlT5fHXC`aji-c{U(J@qh-mWl-uMN|T&435 z5)a1dvB|oe%b2mefc=Vpm0C%IUYYh7HI*;3UdgNIz}R##(#{(_>82|zB0L*1i4B5j-xi9O4x10rs_J6*gdRBX=@VJ+==sWb&_Qc6tSOowM{BX@(zawtjl zdU!F4OYw2@Tk1L^%~JCwb|e#3CC>srRHQ*(N%!7$Mu_sKh@|*XtR>)BmWw!;8-mq7 zBBnbjwx8Kyv|hd*`5}84flTHR1Y@@uqjG`UG+jN_YK&RYTt7DVwfEDXDW4U+iO{>K zw1hr{_XE*S*K9TzzUlJH2rh^hUm2v7_XjwTuYap|>zeEDY$HOq3X4Tz^X}E9z)x4F zs+T?Ed+Hj<#jY-`Va~fT2C$=qFT-5q$@p9~0{G&eeL~tiIAHXA!f6C(rAlS^)&k<- zXU|ZVs}XQ>s5iONo~t!XXZgtaP$Iau;JT%h)>}v54yut~pykaNye4axEK#5@?TSsQ zE;Jvf9I$GVb|S`7$pG)4vgo9NXsKr?u=F!GnA%VS2z$@Z(!MR9?EPcAqi5ft)Iz6sNl`%kj+_H-X`R<>BFrBW=fSlD|{`D%@Rcbu2?%>t7i34k?Ujb)2@J-`j#4 zLK<69qcUuniIan-$A1+fR=?@+thwDIXtF1Tks@Br-xY zfB+zblrR(ke`U;6U~-;p1Kg8Lh6v~LjW@9l2P6s+?$2!ZRPX`(ZkRGe7~q(4&gEi<$ch`5kQ?*1=GSqkeV z{SA1EaW_A!t{@^UY2D^YO0(H@+kFVzZaAh0_`A`f(}G~EP~?B|%gtxu&g%^x{EYSz zk+T;_c@d;+n@$<>V%P=nk36?L!}?*=vK4>nJSm+1%a}9UlmTJTrfX4{Lb7smNQn@T zw9p2%(Zjl^bWGo1;DuMHN(djsEm)P8mEC2sL@KyPjwD@d%QnZ$ zMJ3cnn!_!iP{MzWk%PI&D?m?C(y2d|2VChluN^yHya(b`h>~GkI1y;}O_E57zOs!{ zt2C@M$^PR2U#(dZmA-sNreB@z-yb0Bf7j*yONhZG=onhx>t4)RB`r6&TP$n zgmN*)eCqvgriBO-abHQ8ECN0bw?z5Bxpx z=jF@?zFdVn?@gD5egM4o$m`}lV(CWrOKKq(sv*`mNcHcvw&Xryfw<{ch{O&qc#WCTXX6=#{MV@q#iHYba!OUY+MGeNTjP%Fj!WgM&`&RlI^=AWTOqy-o zHo9YFt!gQ*p7{Fl86>#-JLZo(b^O`LdFK~OsZBRR@6P?ad^Ujbqm_j^XycM4ZHFyg ziUbIFW#2tj`65~#2V!4z7DM8Z;fG0|APaQ{a2VNYpNotB7eZ5kp+tPDz&Lqs0j%Y4tA*URpcfi z_M(FD=fRGdqf430j}1z`O0I=;tLu81bwJXdYiN7_&a-?ly|-j*+=--XGvCq#32Gh(=|qj5F?kmihk{%M&$}udW5)DHK zF_>}5R8&&API}o0osZJRL3n~>76nUZ&L&iy^s>PMnNcYZ|9*1$v-bzbT3rpWsJ+y{ zPrg>5Zlery96Um?lc6L|)}&{992{_$J&=4%nRp9BAC6!IB=A&=tF>r8S*O-=!G(_( zwXbX_rGZgeiK*&n5E;f=k{ktyA1(;x_kiMEt0*gpp_4&(twlS2e5C?NoD{n>X2AT# zY@Zp?#!b1zNq96MQqeO*M1MMBin5v#RH52&Xd~DO6-BZLnA6xO1$sou(YJ1Dlc{WF zVa%2DyYm`V#81jP@70IJ;DX@y*iUt$MLm)ByAD$eUuji|5{ptFYq(q)mE(5bOpxjM z^Q`AHWq44SG3`_LxC9fwR)XRVIp=B%<(-lOC3jI#bb@dK(*vjom!=t|#<@dZql%>O z15y^{4tQoeW9Lu%G&V$90x6F)xN6y_oIn;!Q zs)8jT$;&;u%Y>=T3hg34A-+Y*na=|glcStr5D;&5*t5*DmD~x;zQAV5{}Ya`?RRGa zT*t9@$a~!co;pD^!J5bo?lDOWFx%)Y=-fJ+PDGc0>;=q=s?P4aHForSB+)v0WY2JH z?*`O;RHum6j%#LG)Vu#ciO#+jRC3!>T(9fr+XE7T2B7Z|0nR5jw@WG)kDDzTJ=o4~ zUpeyt7}_nd`t}j9BKqryOha{34erm)RmST)_9Aw)@ zHbiyg5n&E{_CQR@h<}34d7WM{s{%5wdty1l+KX8*?+-YkNK2Be*6&jc>@{Fd;Ps|| z26LqdI3#9le?;}risDq$K5G3yoqK}C^@-8z^wj%tdgw-6@F#Ju{Sg7+y)L?)U$ez> zoOaP$UFZ?y5BiFycir*pnaAaY+|%1%8&|(@VB)zweR%?IidwJyK5J!STzw&2RFx zZV@qeaCB01Hu#U9|1#=Msc8Pgz5P*4Lrp!Q+~(G!OiNR{qa7|r^H?FC6gVhkk3y7=uW#Sh;&>78bZ}aK*C#NH$9rX@M3f{nckYI+5QG?Aj1DM)@~z_ zw!UAD@gedTlePB*%4+55naJ8ak_;))#S;4ji!LOqY5VRI){GMwHR~}6t4g>5C_#U# ztYC!tjKjrKvRy=GAsJVK++~$|+s!w9z3H4G^mACv=EErXNSmH7qN}%PKcN|8%9=i)qS5+$L zu&ya~HW%RMVJi4T^pv?>mw*Gf<)-7gf#Qj|e#w2|v4#t!%Jk{&xlf;$_?jW*n!Pyx zkG$<18kiLOAUPuFfyu-EfWX%4jYnjBYc~~*9JEz6oa)_R|8wjZA|RNrAp%}14L7fW zi7A5Wym*K+V8pkqqO-X#3ft{0qs?KVt^)?kS>AicmeO&q+~J~ zp0YJ_P~_a8j= zsAs~G=8F=M{4GZL{|B__UorX@MRNQLn?*_gym4aW(~+i13knnk1P=khoC-ViMZk+x zLW(l}oAg1H`dU+Fv**;qw|ANDSRs>cGqL!Yw^`; zv;{E&8CNJcc)GHzTYM}f&NPw<6j{C3gaeelU#y!M)w-utYEHOCCJo|Vgp7K6C_$14 zqIrLUB0bsgz^D%V%fbo2f9#yb#CntTX?55Xy|Kps&Xek*4_r=KDZ z+`TQuv|$l}MWLzA5Ay6Cvsa^7xvwXpy?`w(6vx4XJ zWuf1bVSb#U8{xlY4+wlZ$9jjPk)X_;NFMqdgq>m&W=!KtP+6NL57`AMljW+es zzqjUjgz;V*kktJI?!NOg^s_)ph45>4UDA!Vo0hn>KZ+h-3=?Y3*R=#!fOX zP$Y~+14$f66ix?UWB_6r#fMcC^~X4R-<&OD1CSDNuX~y^YwJ>sW0j`T<2+3F9>cLo z#!j57$ll2K9(%$4>eA7(>FJX5e)pR5&EZK!IMQzOfik#FU*o*LGz~7u(8}XzIQRy- z!U7AlMTIe|DgQFmc%cHy_9^{o`eD%ja_L>ckU6$O4*U**o5uR7`FzqkU8k4gxtI=o z^P^oGFPm5jwZMI{;nH}$?p@uV8FT4r=|#GziKXK07bHJLtK}X%I0TON$uj(iJ`SY^ zc$b2CoxCQ>7LH@nxcdW&_C#fMYBtTxcg46dL{vf%EFCZ~eErMvZq&Z%Lhumnkn^4A zsx$ay(FnN7kYah}tZ@0?-0Niroa~13`?hVi6`ndno`G+E8;$<6^gsE-K3)TxyoJ4M zb6pj5=I8^FD5H@`^V#Qb2^0cx7wUz&cruA5g>6>qR5)O^t1(-qqP&1g=qvY#s&{bx zq8Hc%LsbK1*%n|Y=FfojpE;w~)G0-X4i*K3{o|J7`krhIOd*c*$y{WIKz2n2*EXEH zT{oml3Th5k*vkswuFXdGDlcLj15Nec5pFfZ*0?XHaF_lVuiB%Pv&p7z)%38}%$Gup zVTa~C8=cw%6BKn_|4E?bPNW4PT7}jZQLhDJhvf4z;~L)506IE0 zX!tWXX(QOQPRj-p80QG79t8T2^az4Zp2hOHziQlvT!|H)jv{Ixodabzv6lBj)6WRB z{)Kg@$~~(7$-az?lw$4@L%I&DI0Lo)PEJJziWP33a3azb?jyXt1v0N>2kxwA6b%l> zZqRpAo)Npi&loWbjFWtEV)783BbeIAhqyuc+~>i7aQ8shIXt)bjCWT6$~ro^>99G} z2XfmT0(|l!)XJb^E!#3z4oEGIsL(xd; zYX1`1I(cG|u#4R4T&C|m*9KB1`UzKvho5R@1eYtUL9B72{i(ir&ls8g!pD ztR|25xGaF!4z5M+U@@lQf(12?xGy`!|3E}7pI$k`jOIFjiDr{tqf0va&3pOn6Pu)% z@xtG2zjYuJXrV)DUrIF*y<1O1<$#54kZ#2;=X51J^F#0nZ0(;S$OZDt_U2bx{RZ=Q zMMdd$fH|!s{ zXq#l;{`xfV`gp&C>A`WrQU?d{!Ey5(1u*VLJt>i27aZ-^&2IIk=zP5p+{$q(K?2(b z8?9h)kvj9SF!Dr zoyF}?V|9;6abHxWk2cEvGs$-}Pg}D+ZzgkaN&$Snp%;5m%zh1E#?Wac-}x?BYlGN#U#Mek*}kek#I9XaHt?mz3*fDrRTQ#&#~xyeqJk1QJ~E$7qsw6 z?sV;|?*=-{M<1+hXoj?@-$y+(^BJ1H~wQ9G8C0#^aEAyhDduNX@haoa=PuPp zYsGv8UBfQaRHgBgLjmP^eh>fLMeh{8ic)?xz?#3kX-D#Z{;W#cd_`9OMFIaJg-=t`_3*!YDgtNQ2+QUEAJB9M{~AvT$H`E)IKmCR21H532+ata8_i_MR@ z2Xj<3w<`isF~Ah$W{|9;51ub*f4#9ziKrOR&jM{x7I_7()O@`F*5o$KtZ?fxU~g`t zUovNEVKYn$U~VX8eR)qb`7;D8pn*Pp$(otYTqL)5KH$lUS-jf}PGBjy$weoceAcPp z&5ZYB$r&P$MN{0H0AxCe4Qmd3T%M*5d4i%#!nmBCN-WU-4m4Tjxn-%j3HagwTxCZ9 z)j5vO-C7%s%D!&UfO>bi2oXiCw<-w{vVTK^rVbv#W=WjdADJy8$khnU!`ZWCIU`># zyjc^1W~pcu>@lDZ{zr6gv%)2X4n27~Ve+cQqcND%0?IFSP4sH#yIaXXYAq^z3|cg` z`I3$m%jra>e2W-=DiD@84T!cb%||k)nPmEE09NC%@PS_OLhkrX*U!cgD*;;&gIaA(DyVT4QD+q_xu z>r`tg{hiGY&DvD-)B*h+YEd+Zn)WylQl}<4>(_NlsKXCRV;a)Rcw!wtelM2_rWX`j zTh5A|i6=2BA(iMCnj_fob@*eA;V?oa4Z1kRBGaU07O70fb6-qmA$Hg$ps@^ka1=RO zTbE_2#)1bndC3VuK@e!Sftxq4=Uux}fDxXE#Q5_x=E1h>T5`DPHz zbH<_OjWx$wy7=%0!mo*qH*7N4tySm+R0~(rbus`7;+wGh;C0O%x~fEMkt!eV>U$`i z5>Q(o z=t$gPjgGh0&I7KY#k50V7DJRX<%^X z>6+ebc9efB3@eE2Tr){;?_w`vhgF>`-GDY(YkR{9RH(MiCnyRtd!LxXJ75z+?2 zGi@m^+2hKJ5sB1@Xi@s_@p_Kwbc<*LQ_`mr^Y%j}(sV_$`J(?_FWP)4NW*BIL~sR>t6 zM;qTJZ~GoY36&{h-Pf}L#y2UtR}>ZaI%A6VkU>vG4~}9^i$5WP2Tj?Cc}5oQxe2=q z8BeLa$hwCg_psjZyC2+?yX4*hJ58Wu^w9}}7X*+i5Rjqu5^@GzXiw#SUir1G1`jY% zOL=GE_ENYxhcyUrEt9XlMNP6kx6h&%6^u3@zB8KUCAa18T(R2J`%JjWZ z!{7cXaEW+Qu*iJPu+m>QqW}Lo$4Z+!I)0JNzZ&_M%=|B1yejFRM04bGAvu{=lNPd+ zJRI^DRQ(?FcVUD+bgEcAi@o(msqys9RTCG#)TjI!9~3-dc`>gW;HSJuQvH~d`MQs86R$|SKXHh zqS9Qy)u;T`>>a!$LuaE2keJV%;8g)tr&Nnc;EkvA-RanHXsy)D@XN0a>h}z2j81R; zsUNJf&g&rKpuD0WD@=dDrPHdBoK42WoBU|nMo17o(5^;M|dB4?|FsAGVrSyWcI`+FVw^vTVC`y}f(BwJl zrw3Sp151^9=}B})6@H*i4-dIN_o^br+BkcLa^H56|^2XsT0dESw2 zMX>(KqNl=x2K5=zIKg}2JpGAZu{I_IO}0$EQ5P{4zol**PCt3F4`GX}2@vr8#Y)~J zKb)gJeHcFnR@4SSh%b;c%J`l=W*40UPjF#q{<}ywv-=vHRFmDjv)NtmC zQx9qm)d%0zH&qG7AFa3VAU1S^(n8VFTC~Hb+HjYMjX8r#&_0MzlNR*mnLH5hi}`@{ zK$8qiDDvS_(L9_2vHgzEQ${DYSE;DqB!g*jhJghE&=LTnbgl&Xepo<*uRtV{2wDHN z)l;Kg$TA>Y|K8Lc&LjWGj<+bp4Hiye_@BfU(y#nF{fpR&|Ltbye?e^j0}8JC4#xi% zv29ZR%8%hk=3ZDvO-@1u8KmQ@6p%E|dlHuy#H1&MiC<*$YdLkHmR#F3ae;bKd;@*i z2_VfELG=B}JMLCO-6UQy^>RDE%K4b>c%9ki`f~Z2Qu8hO7C#t%Aeg8E%+}6P7Twtg z-)dj(w}_zFK&86KR@q9MHicUAucLVshUdmz_2@32(V`y3`&Kf8Q2I)+!n0mR=rrDU zXvv^$ho;yh*kNqJ#r1}b0|i|xRUF6;lhx$M*uG3SNLUTC@|htC z-=fsw^F%$qqz4%QdjBrS+ov}Qv!z00E+JWas>p?z@=t!WWU3K*?Z(0meTuTOC7OTx zU|kFLE0bLZ+WGcL$u4E}5dB0g`h|uwv3=H6f+{5z9oLv-=Q45+n~V4WwgO=CabjM% zBAN+RjM65(-}>Q2V#i1Na@a0`08g&y;W#@sBiX6Tpy8r}*+{RnyGUT`?XeHSqo#|J z^ww~c;ou|iyzpErDtlVU=`8N7JSu>4M z_pr9=tX0edVn9B}YFO2y(88j#S{w%E8vVOpAboK*27a7e4Ekjt0)hIX99*1oE;vex z7#%jhY=bPijA=Ce@9rRO(Vl_vnd00!^TAc<+wVvRM9{;hP*rqEL_(RzfK$er_^SN; z)1a8vo8~Dr5?;0X0J62Cusw$A*c^Sx1)dom`-)Pl7hsW4i(r*^Mw`z5K>!2ixB_mu z*Ddqjh}zceRFdmuX1akM1$3>G=#~|y?eYv(e-`Qy?bRHIq=fMaN~fB zUa6I8Rt=)jnplP>yuS+P&PxeWpJ#1$F`iqRl|jF$WL_aZFZl@kLo&d$VJtu&w?Q0O zzuXK>6gmygq(yXJy0C1SL}T8AplK|AGNUOhzlGeK_oo|haD@)5PxF}rV+5`-w{Aag zus45t=FU*{LguJ11Sr-28EZkq;!mJO7AQGih1L4rEyUmp>B!%X0YemsrV3QFvlgt* z5kwlPzaiJ+kZ^PMd-RRbl(Y?F*m`4*UIhIuf#8q>H_M=fM*L_Op-<_r zBZagV=4B|EW+KTja?srADTZXCd3Yv%^Chfpi)cg{ED${SI>InNpRj5!euKv?=Xn92 zsS&FH(*w`qLIy$doc>RE&A5R?u zzkl1sxX|{*fLpXvIW>9d<$ePROttn3oc6R!sN{&Y+>Jr@yeQN$sFR z;w6A<2-0%UA?c8Qf;sX7>>uKRBv3Ni)E9pI{uVzX|6Bb0U)`lhLE3hK58ivfRs1}d zNjlGK0hdq0qjV@q1qI%ZFMLgcpWSY~mB^LK)4GZ^h_@H+3?dAe_a~k*;9P_d7%NEFP6+ zgV(oGr*?W(ql?6SQ~`lUsjLb%MbfC4V$)1E0Y_b|OIYxz4?O|!kRb?BGrgiH5+(>s zoqM}v*;OBfg-D1l`M6T6{K`LG+0dJ1)!??G5g(2*vlNkm%Q(MPABT$r13q?|+kL4- zf)Mi5r$sn;u41aK(K#!m+goyd$c!KPl~-&-({j#D4^7hQkV3W|&>l_b!}!z?4($OA z5IrkfuT#F&S1(`?modY&I40%gtroig{YMvF{K{>5u^I51k8RriGd${z)=5k2tG zM|&Bp5kDTfb#vfuTTd?)a=>bX=lokw^y9+2LS?kwHQIWI~pYgy7 zb?A-RKVm_vM5!9?C%qYdfRAw& zAU7`up~%g=p@}pg#b7E)BFYx3g%(J36Nw(Dij!b>cMl@CSNbrW!DBDbTD4OXk!G4x zi}JBKc8HBYx$J~31PXH+4^x|UxK~(<@I;^3pWN$E=sYma@JP|8YL`L(zI6Y#c%Q{6 z*APf`DU$S4pr#_!60BH$FGViP14iJmbrzSrOkR;f3YZa{#E7Wpd@^4E-zH8EgPc-# zKWFPvh%WbqU_%ZEt`=Q?odKHc7@SUmY{GK`?40VuL~o)bS|is$Hn=<=KGHOsEC5tB zFb|q}gGlL97NUf$G$>^1b^3E18PZ~Pm9kX%*ftnolljiEt@2#F2R5ah$zbXd%V_Ev zyDd{1o_uuoBga$fB@Fw!V5F3jIr=a-ykqrK?WWZ#a(bglI_-8pq74RK*KfQ z0~Dzus7_l;pMJYf>Bk`)`S8gF!To-BdMnVw5M-pyu+aCiC5dwNH|6fgRsIKZcF&)g zr}1|?VOp}I3)IR@m1&HX1~#wsS!4iYqES zK}4J{Ei>;e3>LB#Oly>EZkW14^@YmpbgxCDi#0RgdM${&wxR+LiX}B+iRioOB0(pDKpVEI;ND?wNx>%e|m{RsqR_{(nmQ z3ZS}@t!p4a(BKx_-CYwrcyJ5u1TO9bcXti$8sy>xcLKqKCc#~UOZYD{llKTSFEjJ~ zyNWt>tLU}*>^`TvPxtP%F`ZJQw@W0^>x;!^@?k_)9#bF$j0)S3;mH-IR5y82l|%=F z2lR8zhP?XNP-ucZZ6A+o$xOyF!w;RaLHGh57GZ|TCXhJqY~GCh)aXEV$1O&$c}La1 zjuJxkY9SM4av^Hb;i7efiYaMwI%jGy`3NdY)+mcJhF(3XEiSlU3c|jMBi|;m-c?~T z+x0_@;SxcoY=(6xNgO$bBt~Pj8`-<1S|;Bsjrzw3@zSjt^JC3X3*$HI79i~!$RmTz zsblZsLYs7L$|=1CB$8qS!tXrWs!F@BVuh?kN(PvE5Av-*r^iYu+L^j^m9JG^#=m>@ z=1soa)H*w6KzoR$B8mBCXoU;f5^bVuwQ3~2LKg!yxomG1#XPmn(?YH@E~_ED+W6mxs%x{%Z<$pW`~ON1~2XjP5v(0{C{+6Dm$00tsd3w=f=ZENy zOgb-=f}|Hb*LQ$YdWg<(u7x3`PKF)B7ZfZ6;1FrNM63 z?O6tE%EiU@6%rVuwIQjvGtOofZBGZT1Sh(xLIYt9c4VI8`!=UJd2BfLjdRI#SbVAX ziT(f*RI^T!IL5Ac>ql7uduF#nuCRJ1)2bdvAyMxp-5^Ww5p#X{rb5)(X|fEhDHHW{ zw(Lfc$g;+Q`B0AiPGtmK%*aWfQQ$d!*U<|-@n2HZvCWSiw^I>#vh+LyC;aaVWGbmkENr z&kl*8o^_FW$T?rDYLO1Pyi%>@&kJKQoH2E0F`HjcN}Zlnx1ddoDA>G4Xu_jyp6vuT zPvC}pT&Owx+qB`zUeR|4G;OH(<<^_bzkjln0k40t`PQxc$7h(T8Ya~X+9gDc8Z9{Z z&y0RAU}#_kQGrM;__MK9vwIwK^aoqFhk~dK!ARf1zJqHMxF2?7-8|~yoO@_~Ed;_wvT%Vs{9RK$6uUQ|&@#6vyBsFK9eZW1Ft#D2)VpQRwpR(;x^ zdoTgMqfF9iBl%{`QDv7B0~8{8`8k`C4@cbZAXBu00v#kYl!#_Wug{)2PwD5cNp?K^ z9+|d-4z|gZ!L{57>!Ogfbzchm>J1)Y%?NThxIS8frAw@z>Zb9v%3_3~F@<=LG%r*U zaTov}{{^z~SeX!qgSYow`_5)ij*QtGp4lvF`aIGQ>@3ZTkDmsl#@^5*NGjOuu82}o zzLF~Q9SW+mP=>88%eSA1W4_W7-Q>rdq^?t=m6}^tDPaBRGFLg%ak93W!kOp#EO{6& zP%}Iff5HZQ9VW$~+9r=|Quj#z*=YwcnssS~9|ub2>v|u1JXP47vZ1&L1O%Z1DsOrDfSIMHU{VT>&>H=9}G3i@2rP+rx@eU@uE8rJNec zij~#FmuEBj03F1~ct@C@$>y)zB+tVyjV3*n`mtAhIM0$58vM9jOQC}JJOem|EpwqeMuYPxu3sv}oMS?S#o6GGK@8PN59)m&K4Dc&X% z(;XL_kKeYkafzS3Wn5DD>Yiw{LACy_#jY4op(>9q>>-*9@C0M+=b#bknAWZ37^(Ij zq>H%<@>o4a#6NydoF{_M4i4zB_KG)#PSye9bk0Ou8h%1Dtl7Q_y#7*n%g)?m>xF~( zjqvOwC;*qvN_3(*a+w2|ao0D?@okOvg8JskUw(l7n`0fncglavwKd?~l_ryKJ^Ky! zKCHkIC-o7%fFvPa$)YNh022lakMar^dgL=t#@XLyNHHw!b?%WlM)R@^!)I!smZL@k zBi=6wE5)2v&!UNV(&)oOYW(6Qa!nUjDKKBf-~Da=#^HE4(@mWk)LPvhyN3i4goB$3K8iV7uh zsv+a?#c4&NWeK(3AH;ETrMOIFgu{_@%XRwCZ;L=^8Ts)hix4Pf3yJRQ<8xb^CkdmC z?c_gB)XmRsk`9ch#tx4*hO=#qS7={~Vb4*tTf<5P%*-XMfUUYkI9T1cEF;ObfxxI-yNuA=I$dCtz3ey znVkctYD*`fUuZ(57+^B*R=Q}~{1z#2!ca?)+YsRQb+lt^LmEvZt_`=j^wqig+wz@n@ z`LIMQJT3bxMzuKg8EGBU+Q-6cs5(@5W?N>JpZL{$9VF)veF`L5%DSYTNQEypW%6$u zm_~}T{HeHj1bAlKl8ii92l9~$dm=UM21kLemA&b$;^!wB7#IKWGnF$TVq!!lBlG4 z{?Rjz?P(uvid+|i$VH?`-C&Gcb3{(~Vpg`w+O);Wk1|Mrjxrht0GfRUnZqz2MhrXa zqgVC9nemD5)H$to=~hp)c=l9?#~Z_7i~=U-`FZxb-|TR9@YCxx;Zjo-WpMNOn2)z) zFPGGVl%3N$f`gp$gPnWC+f4(rmts%fidpo^BJx72zAd7|*Xi{2VXmbOm)1`w^tm9% znM=0Fg4bDxH5PxPEm{P3#A(mxqlM7SIARP?|2&+c7qmU8kP&iApzL|F>Dz)Ixp_`O zP%xrP1M6@oYhgo$ZWwrAsYLa4 z|I;DAvJxno9HkQrhLPQk-8}=De{9U3U%)dJ$955?_AOms!9gia%)0E$Mp}$+0er@< zq7J&_SzvShM?e%V?_zUu{niL@gt5UFOjFJUJ}L?$f%eU%jUSoujr{^O=?=^{19`ON zlRIy8Uo_nqcPa6@yyz`CM?pMJ^^SN^Fqtt`GQ8Q#W4kE7`V9^LT}j#pMChl!j#g#J zr-=CCaV%xyFeQ9SK+mG(cTwW*)xa(eK;_Z(jy)woZp~> zA(4}-&VH+TEeLzPTqw&FOoK(ZjD~m{KW05fiGLe@E3Z2`rLukIDahE*`u!ubU)9`o zn^-lyht#E#-dt~S>}4y$-mSbR8{T@}22cn^refuQ08NjLOv?JiEWjyOnzk<^R5%gO zhUH_B{oz~u#IYwVnUg8?3P*#DqD8#X;%q%HY**=I>>-S|!X*-!x1{^l#OnR56O>iD zc;i;KS+t$koh)E3)w0OjWJl_aW2;xF=9D9Kr>)(5}4FqUbk# zI#$N8o0w;IChL49m9CJTzoC!|u{Ljd%ECgBOf$}&jA^$(V#P#~)`&g`H8E{uv52pp zwto`xUL-L&WTAVREEm$0g_gYPL(^vHq(*t1WCH_6alhkeW&GCZ3hL)|{O-jiFOBrF z!EW=Jej|dqQitT6!B-7&io2K)WIm~Q)v@yq%U|VpV+I?{y0@Yd%n8~-NuuM*pM~KA z85YB};IS~M(c<}4Hxx>qRK0cdl&e?t253N%vefkgds>Ubn8X}j6Vpgs>a#nFq$osY z1ZRwLqFv=+BTb=i%D2Wv>_yE0z}+niZ4?rE|*a3d7^kndWGwnFqt+iZ(7+aln<}jzbAQ(#Z2SS}3S$%Bd}^ zc9ghB%O)Z_mTZMRC&H#)I#fiLuIkGa^`4e~9oM5zKPx?zjkC&Xy0~r{;S?FS%c7w< zWbMpzc(xSw?9tGxG~_l}Acq}zjt5ClaB7-!vzqnlrX;}$#+PyQ9oU)_DfePh2E1<7 ztok6g6K^k^DuHR*iJ?jw?bs_whk|bx`dxu^nC6#e{1*m~z1eq7m}Cf$*^Eua(oi_I zAL+3opNhJteu&mWQ@kQWPucmiP)4|nFG`b2tpC;h{-PI@`+h?9v=9mn|0R-n8#t=+Z*FD(c5 zjj79Jxkgck*DV=wpFgRZuwr%}KTm+dx?RT@aUHJdaX-ODh~gByS?WGx&czAkvkg;x zrf92l8$Or_zOwJVwh>5rB`Q5_5}ef6DjS*$x30nZbuO3dijS*wvNEqTY5p1_A0gWr znH<(Qvb!os14|R)n2Ost>jS2;d1zyLHu`Svm|&dZD+PpP{Bh>U&`Md;gRl64q;>{8MJJM$?UNUd`aC>BiLe>*{ zJY15->yW+<3rLgYeTruFDtk1ovU<$(_y7#HgUq>)r0{^}Xbth}V#6?%5jeFYt;SG^ z3qF)=uWRU;Jj)Q}cpY8-H+l_n$2$6{ZR?&*IGr{>ek!69ZH0ZoJ*Ji+ezzlJ^%qL3 zO5a`6gwFw(moEzqxh=yJ9M1FTn!eo&qD#y5AZXErHs%22?A+JmS&GIolml!)rZTnUDM3YgzYfT#;OXn)`PWv3Ta z!-i|-Wojv*k&bC}_JJDjiAK(Ba|YZgUI{f}TdEOFT2+}nPmttytw7j%@bQZDV1vvj z^rp{gRkCDmYJHGrE1~e~AE!-&6B6`7UxVQuvRrfdFkGX8H~SNP_X4EodVd;lXd^>eV1jN+Tt4}Rsn)R0LxBz0c=NXU|pUe!MQQFkGBWbR3&(jLm z%RSLc#p}5_dO{GD=DEFr=Fc% z85CBF>*t!6ugI?soX(*JNxBp+-DdZ4X0LldiK}+WWGvXV(C(Ht|!3$psR=&c*HIM=BmX;pRIpz@Ale{9dhGe(U2|Giv;# zOc|;?p67J=Q(kamB*aus=|XP|m{jN^6@V*Bpm?ye56Njh#vyJqE=DweC;?Rv7faX~ zde03n^I~0B2vUmr;w^X37tVxUK?4}ifsSH5_kpKZIzpYu0;Kv}SBGfI2AKNp+VN#z`nI{UNDRbo-wqa4NEls zICRJpu)??cj^*WcZ^MAv+;bDbh~gpN$1Cor<{Y2oyIDws^JsfW^5AL$azE(T0p&pP z1Mv~6Q44R&RHoH95&OuGx2srIr<@zYJTOMKiVs;Bx3py89I87LOb@%mr`0)#;7_~Z zzcZj8?w=)>%5@HoCHE_&hnu(n_yQ-L(~VjpjjkbT7e)Dk5??fApg(d>vwLRJ-x{um z*Nt?DqTSxh_MIyogY!vf1mU1`Gld-&L)*43f6dilz`Q@HEz;+>MDDYv9u!s;WXeao zUq=TaL$P*IFgJzrGc>j1dDOd zed+=ZBo?w4mr$2)Ya}?vedDopomhW1`#P<%YOJ_j=WwClX0xJH-f@s?^tmzs_j7t!k zK@j^zS0Q|mM4tVP5Ram$VbS6|YDY&y?Q1r1joe9dj08#CM{RSMTU}(RCh`hp_Rkl- zGd|Cv~G@F{DLhCizAm9AN!^{rNs8hu!G@8RpnGx7e`-+K$ffN<0qjR zGq^$dj_Tv!n*?zOSyk5skI7JVKJ)3jysnjIu-@VSzQiP8r6MzudCU=~?v-U8yzo^7 zGf~SUTvEp+S*!X9uX!sq=o}lH;r{pzk~M*VA(uyQ`3C8!{C;)&6)95fv(cK!%Cuz$ z_Zal57H6kPN>25KNiI6z6F)jzEkh#%OqU#-__Xzy)KyH};81#N6OfX$$IXWzOn`Q& z4f$Z1t>)8&8PcYfEwY5UadU1yg+U*(1m2ZlHoC-!2?gB!!fLhmTl))D@dhvkx#+Yj z1O=LV{(T%{^IeCuFK>%QR!VZ4GnO5tK8a+thWE zg4VytZrwcS?7^ zuZfhYnB8dwd%VLO?DK7pV5Wi<(`~DYqOXn8#jUIL^)12*Dbhk4GmL_E2`WX&iT16o zk(t|hok(Y|v-wzn?4x34T)|+SfZP>fiq!><*%vnxGN~ypST-FtC+@TPv*vYv@iU!_ z@2gf|PrgQ?Ktf*9^CnJ(x*CtZVB8!OBfg0%!wL;Z8(tYYre0vcnPGlyCc$V(Ipl*P z_(J!a=o@vp^%Efme!K74(Ke7A>Y}|sxV+JL^aYa{~m%5#$$+R1? zGaQhZTTX!#s#=Xtpegqero$RNt&`4xn3g$)=y*;=N=Qai)}~`xtxI_N*#MMCIq#HFifT zz(-*m;pVH&+4bixL&Bbg)W5FN^bH87pAHp)zPkWNMfTFqS=l~AC$3FX3kQUSh_C?-ZftyClgM)o_D7cX$RGlEYblux0jv5 zTr|i-I3@ZPCGheCl~BGhImF)K4!9@?pC(gi3ozX=a!|r1)LFxy_8c&wY0<^{2cm|P zv6Y`QktY*;I)IUd5y3ne1CqpVanlY45z8hf4&$EUBnucDj16pDa4&GI&TArYhf*xh zdj>*%APH8(h~c>o@l#%T>R$e>rwVx_WUB|~V`p^JHsg*y12lzj&zF}w6W09HwB2yb z%Q~`es&(;7#*DUC_w-Dmt7|$*?TA_m;zB+-u{2;Bg{O}nV7G_@7~<)Bv8fH^G$XG8$(&{A zwXJK5LRK%M34(t$&NI~MHT{UQ9qN-V_yn|%PqC81EIiSzmMM=2zb`mIwiP_b)x+2M z7Gd`83h79j#SItpQ}luuf2uOU`my_rY5T{6P#BNlb%h%<#MZb=m@y5aW;#o1^2Z)SWo+b`y0gV^iRcZtz5!-05vF z7wNo=hc6h4hc&s@uL^jqRvD6thVYtbErDK9k!;+a0xoE0WL7zLixjn5;$fXvT=O3I zT6jI&^A7k6R{&5#lVjz#8%_RiAa2{di{`kx79K+j72$H(!ass|B%@l%KeeKchYLe_ z>!(JC2fxsv>XVen+Y42GeYPxMWqm`6F$(E<6^s|g(slNk!lL*6v^W2>f6hh^mE$s= z3D$)}{V5(Qm&A6bp%2Q}*GZ5Qrf}n7*Hr51?bJOyA-?B4vg6y_EX<*-e20h{=0Mxs zbuQGZ$fLyO5v$nQ&^kuH+mNq9O#MWSfThtH|0q1i!NrWj^S}_P;Q1OkYLW6U^?_7G zx2wg?CULj7))QU(n{$0JE%1t2dWrMi2g-Os{v|8^wK{@qlj%+1b^?NI z$}l2tjp0g>K3O+p%yK<9!XqmQ?E9>z&(|^Pi~aSRwI5x$jaA62GFz9%fmO3t3a>cq zK8Xbv=5Ps~4mKN5+Eqw12(!PEyedFXv~VLxMB~HwT1Vfo51pQ#D8e$e4pFZ{&RC2P z5gTIzl{3!&(tor^BwZfR8j4k{7Rq#`riKXP2O-Bh66#WWK2w=z;iD9GLl+3 zpHIaI4#lQ&S-xBK8PiQ%dwOh?%BO~DCo06pN7<^dnZCN@NzY{_Z1>rrB0U|nC&+!2 z2y!oBcTd2;@lzyk(B=TkyZ)zy0deK05*Q0zk+o$@nun`VI1Er7pjq>8V zNmlW{p7S^Btgb(TA}jL(uR>`0w8gHP^T~Sh5Tkip^spk4SBAhC{TZU}_Z)UJw-}zm zPq{KBm!k)?P{`-(9?LFt&YN4s%SIZ-9lJ!Ws~B%exHOeVFk3~}HewnnH(d)qkLQ_d z6h>O)pEE{vbOVw}E+jdYC^wM+AAhaI(YAibUc@B#_mDss0Ji&BK{WG`4 zOk>vSNq(Bq2IB@s>>Rxm6Wv?h;ZXkpb1l8u|+_qXWdC*jjcPCixq;!%BVPSp#hP zqo`%cNf&YoQXHC$D=D45RiT|5ngPlh?0T~?lUf*O)){K@*Kbh?3RW1j9-T?%lDk@y z4+~?wKI%Y!-=O|_IuKz|=)F;V7ps=5@g)RrE;;tvM$gUhG>jHcw2Hr@fS+k^Zr~>G z^JvPrZc}_&d_kEsqAEMTMJw!!CBw)u&ZVzmq+ZworuaE&TT>$pYsd9|g9O^0orAe8 z221?Va!l1|Y5X1Y?{G7rt1sX#qFA^?RLG^VjoxPf63;AS=_mVDfGJKg73L zsGdnTUD40y(>S##2l|W2Cy!H(@@5KBa(#gs`vlz}Y~$ot5VsqPQ{{YtjYFvIumZzt zA{CcxZLJR|4#{j7k~Tu*jkwz8QA|5G1$Cl895R`Zyp;irp1{KN){kB30O8P1W5;@bG znvX74roeMmQlUi=v9Y%(wl$ZC#9tKNFpvi3!C}f1m6Ct|l2g%psc{TJp)@yu)*e2> z((p0Fg*8gJ!|3WZke9;Z{8}&NRkv7iP=#_y-F}x^y?2m%-D_aj^)f04%mneyjo_;) z6qc_Zu$q37d~X``*eP~Q>I2gg%rrV8v=kDfpp$=%Vj}hF)^dsSWygoN(A$g*E=Do6FX?&(@F#7pbiJ`;c0c@Ul zDqW_90Wm#5f2L<(Lf3)3TeXtI7nhYwRm(F;*r_G6K@OPW4H(Y3O5SjUzBC}u3d|eQ8*8d@?;zUPE+i#QNMn=r(ap?2SH@vo*m z3HJ%XuG_S6;QbWy-l%qU;8x;>z>4pMW7>R}J%QLf%@1BY(4f_1iixd-6GlO7Vp*yU zp{VU^3?s?90i=!#>H`lxT!q8rk>W_$2~kbpz7eV{3wR|8E=8**5?qn8#n`*(bt1xRQrdGxyx2y%B$qmw#>ZV$c7%cO#%JM1lY$Y0q?Yuo> ze9KdJoiM)RH*SB%^;TAdX-zEjA7@%y=!0=Zg%iWK7jVI9b&Dk}0$Af&08KHo+ zOwDhFvA(E|ER%a^cdh@^wLUlmIv6?_3=BvX8jKk92L=Y}7Jf5OGMfh` zBdR1wFCi-i5@`9km{isRb0O%TX+f~)KNaEz{rXQa89`YIF;EN&gN)cigu6mNh>?Cm zAO&Im2flv6D{jwm+y<%WsPe4!89n~KN|7}Cb{Z;XweER73r}Qp2 zz}WP4j}U0&(uD&9yGy6`!+_v-S(yG*iytsTR#x_Rc>=6u^vnRDnf1gP{#2>`ffrAC% zTZ5WQ@hAK;P;>kX{D)mIXe4%a5p=LO1xXH@8T?mz7Q@d)$3pL{{B!2{-v70L*o1AO+|n5beiw~ zk@(>m?T3{2k2c;NWc^`4@P&Z?BjxXJ@;x1qhn)9Mn*IFdt_J-dIqx5#d`NfyfX~m( zIS~5)MfZ2Uy?_4W`47i}u0ZgPh<{D|w_d#;D}Q&U$Q-G}xM1A@1f{#%A$jh6Qp&0hQ<0bPOM z-{1Wm&p%%#eb_?x7i;bol EfAhh=DF6Tf literal 0 HcmV?d00001 diff --git a/.mvn/wrapper/maven-wrapper.properties b/.mvn/wrapper/maven-wrapper.properties new file mode 100644 index 0000000..642d572 --- /dev/null +++ b/.mvn/wrapper/maven-wrapper.properties @@ -0,0 +1,2 @@ +distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip +wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..f49a4e1 --- /dev/null +++ b/LICENSE @@ -0,0 +1,201 @@ + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..b06c598 --- /dev/null +++ b/README.md @@ -0,0 +1,84 @@ +# ksqlDB Java Client + +This library is a Java wrapper to the ksqlDB Rest API. It offers a reactive API to interact with ksqlDB. + +This project is in an early state but currently offers supports of all the ksqlDB public APIs. + +It will soon be available on Maven Central. + +## Version compatibility + +| ksqlDB Java Client version | ksqlDB | Confluent Platform | +|---|---|---| +| 0.2.x | 0.6.x | 5.4.x | + +## Usage + +### Dependencies + +In pom.xml, add the following repository and dependencies. + +```xml + + ... + + oss-sonatype-snapshot + https://oss.sonatype.org/content/repositories/snapshots + + + + + ... + + dev.daniellavoie.ksqldb + ksqldb-java-client + 0.2.0-SNAPSHOT + + +``` + +### Consuming a Push Query + +```java + KsqlDBClient.create("http://localhost:8088") + + .pushQuery(new QueryRequest("SELECT * FROM MY_TABLE WHERE ROWKEY='1' EMIT CHANGES;")) + + .doOnNext(queryRow -> System.out.println("Received a new row : " + queryRow + ".")) + + .doOnError(throwable -> throwable.printStackTrace()) + + .subscribe(); +``` + +### Consuming a Pull Query + +```java + KsqlDBClient.create("http://localhost:8088") + + .pullQuery(new QueryRequest("SELECT * FROM MY_TABLE WHERE ROWKEY='1';")) + + .doOnNext(queryRow -> System.out.println("Received a new row : " + queryRow + ".")) + + .doOnError(throwable -> throwable.printStackTrace()) + + .doOnComplete(() -> System.out.println("Request completed."))) + + .subscribe(); +``` + +## Working with the reactive API + +This Java Client relies heavily on [Project Reactor](https://projectreactor.io/) to offer a reactive API for all operations related to ksqlDB. + +The operators from Reactor are similar to the ones available within Kafka Streams. + +A reactive hands on workshop is available online [here](https://tech.io/playgrounds/929/reactive-programming-with-reactor-3/Intro) and is a good primer to learn reactive programming with Java. + +## Supported API + +This client library supports all APIs offered by ksqlDB. More documentation will be provided in a near future. The `KsqlDBClient` class offers methods to interract with all REST Endpoints of ksqlDB documented [here](https://docs.ksqldb.io/en/latest/developer-guide/api/). + +## Upcoming improvement + +* Support Object binding with a higher level API. diff --git a/client/.gitignore b/client/.gitignore new file mode 100644 index 0000000..beef00d --- /dev/null +++ b/client/.gitignore @@ -0,0 +1,4 @@ +.classpath +.project +.settings +target diff --git a/client/pom.xml b/client/pom.xml new file mode 100644 index 0000000..f3c9484 --- /dev/null +++ b/client/pom.xml @@ -0,0 +1,60 @@ + + + 4.0.0 + + + dev.daniellavoie.ksqldb + ksqldb-java-client-parent + 0.2.0-SNAPSHOT + .. + + + ksqldb-java-client + + Non-Blocking Reactive Java Client for ksqlDB + Non-Blocking Reactive Java Client for ksqlDB + + + 1.8 + 1.8 + + 2.10.0 + 1.1.1 + 0.9.2.RELEASE + + + + + + com.fasterxml.jackson.core + jackson-databind + ${jackson.version} + + + io.projectreactor.netty + reactor-netty + ${reactor-netty.version} + + + org.slf4j + slf4j-api + 1.7.28 + + + + + + + com.fasterxml.jackson.core + jackson-databind + + + io.projectreactor.netty + reactor-netty + + + org.slf4j + slf4j-api + + + diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/AdminUtil.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/AdminUtil.java new file mode 100644 index 0000000..4a84bac --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/AdminUtil.java @@ -0,0 +1,83 @@ +/* + * Copyright 2012-2020 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +import java.util.List; +import java.util.stream.Collectors; + +import dev.daniellavoie.ksqldb.client.api.ksql.CommandResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import reactor.core.publisher.Mono; + +/** + * Offers utility functions to help managing ksqlDB streams and tables. + * + * @author Daniel Lavoie + * @since 0.1.0 + */ +public class AdminUtil { + private KsqlDBClient ksqlDBClient; + + AdminUtil(KsqlDBClient ksqlDBClient) { + this.ksqlDBClient = ksqlDBClient; + } + + /** + * Checks if any of the streams in ksqlDB already exists with the given name. + * Will create a new stream with the provided configuration it does not already + * exists. + * + * @param streamName name of the stream + * @param topicName topic on which the stream is based + * @param valueFormat value format for the stream + * @param columnDefinitions List of all the columns + * @return a {@link Mono} that emits true if the stream is created or false if + * it's already present. + */ + public Mono createStreamIfMissing(String streamName, String topicName, ValueFormat valueFormat, + List columnDefinitions) { + + return ksqlDBClient.streams(new KsqlRequest("SHOW STREAMS;")).flatMapIterable(response -> response.getStreams()) + .filter(stream -> stream.getName().equals(streamName)) + + .map(stream -> false) + + .switchIfEmpty(createStreamFromTopic(streamName, topicName, valueFormat, columnDefinitions) + .map(response -> true)) + + .last(); + } + + /** + * Generates and executes a ksqlDB request to create a stream with the provided + * configuration. + * + * @param streamName name of the stream + * @param topicName topic on which the stream is based + * @param valueFormat value format for the stream + * @param columnDefinitions List of all the columns + * @return a {@link Mono} that emits a response for the ksqlDB statement. + */ + public Mono createStreamFromTopic(String streamName, String topicName, ValueFormat valueFormat, + List columnDefinitions) { + String fields = columnDefinitions.stream().map(entry -> entry.getName() + " " + entry.getDataType()) + .collect(Collectors.joining(", ")); + + return ksqlDBClient.execute(new KsqlRequest("CREATE STREAM " + streamName + " (" + fields + + ") WITH (kafka_topic='" + topicName + "', value_format='" + valueFormat + "');")).last(); + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/ColumnDefinition.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/ColumnDefinition.java new file mode 100644 index 0000000..500465c --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/ColumnDefinition.java @@ -0,0 +1,42 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +/** + * Represents a Field definition for a KSQL query. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class ColumnDefinition { + private final String name; + private final String dataType; + + public ColumnDefinition(String name, String dataType) { + this.name = name; + this.dataType = dataType; + } + + public String getName() { + return name; + } + + public String getDataType() { + return dataType; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/DataType.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/DataType.java new file mode 100644 index 0000000..3191245 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/DataType.java @@ -0,0 +1,28 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +/** + * Supported Data type for the KSQL Schema. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public enum DataType { + BOOLEAN, INTEGER, BIGINT, DOUBLE, STRING, ARRAY, MAP, STRUCT, DECIMAL +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/DefaultKsqlDBClient.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/DefaultKsqlDBClient.java new file mode 100644 index 0000000..1d4c293 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/DefaultKsqlDBClient.java @@ -0,0 +1,211 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +import java.util.HashMap; +import java.util.Map; +import java.util.function.Function; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.fasterxml.jackson.core.type.TypeReference; + +import dev.daniellavoie.ksqldb.client.api.info.HealthcheckResponse; +import dev.daniellavoie.ksqldb.client.api.info.InfoResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.CommandResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.DescribeResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.ExplainResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import dev.daniellavoie.ksqldb.client.api.ksql.PropertiesResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.QueriesResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.StreamsResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.TablesResponse; +import dev.daniellavoie.ksqldb.client.api.query.QueryRequest; +import dev.daniellavoie.ksqldb.client.api.query.QueryResponse; +import dev.daniellavoie.ksqldb.client.model.QueryRow; +import reactor.core.publisher.Flux; +import reactor.core.publisher.Mono; + +/** + * Default implementation for {@link KsqlDBClient}. Leverages + * {@link ReactorWebClient} as a HTTP Client. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class DefaultKsqlDBClient implements KsqlDBClient { + private static final Logger LOGGER = LoggerFactory.getLogger(DefaultKsqlDBClient.class); + + private final WebClient webClient; + private final AdminUtil adminUtil; + + public DefaultKsqlDBClient(String ksqlDBUrl, String ksqlDBWebSocketUrl) { + webClient = new ReactorWebClient(ksqlDBUrl, ksqlDBWebSocketUrl); + adminUtil = new AdminUtil(this); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux describe(KsqlRequest ksqlRequest) { + return webClient.post("/ksql", ksqlRequest, new TypeReference() { + }).flatMapMany(responses -> Flux.fromArray(responses)); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux execute(KsqlRequest ksqlRequest) { + return webClient.post("/ksql", ksqlRequest, new TypeReference() { + }).flatMapMany(responses -> Flux.fromArray(responses)); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux explain(KsqlRequest ksqlRequest) { + return webClient.post("/ksql", ksqlRequest, new TypeReference() { + }).flatMapMany(responses -> Flux.fromArray(responses)); + } + + /** + * {@inheritDoc} + */ + @Override + public AdminUtil getAdminUtil() { + return adminUtil; + } + + /** + * {@inheritDoc} + */ + @Override + public Mono getHealthcheck() { + return webClient.get("/healthcheck", HealthcheckResponse.class); + } + + /** + * {@inheritDoc} + */ + @Override + public Mono getInfo() { + return webClient.get("/info", InfoResponse.class); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux properties(KsqlRequest ksqlRequest) { + return webClient.post("/ksql", ksqlRequest, new TypeReference() { + }).flatMapMany(responses -> Flux.fromArray(responses)); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux pullQuery(QueryRequest queryRequest) { + Flux responseFlux = webClient + .postForMany("/query", queryRequest, new TypeReference() { + }).flatMap(responses -> Flux.fromArray(responses)); + + return responseFlux.flatMap(new QueryResponseMapper()); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux pushQuery(QueryRequest queryRequest) { + Map params = new HashMap<>(); + + params.put("request", JsonUtil.writeValueAsString(queryRequest)); + + return webClient.getWithWebSocket("/ws/query", params).flatMap(new WebSocketQueryResponseMapper()); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux queries(KsqlRequest ksqlRequest) { + return webClient.post("/ksql", ksqlRequest, new TypeReference() { + }).flatMapMany(responses -> Flux.fromArray(responses)); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux streams(KsqlRequest ksqlRequest) { + return webClient.post("/ksql", ksqlRequest, new TypeReference() { + }).flatMapMany(responses -> Flux.fromArray(responses)); + } + + /** + * {@inheritDoc} + */ + @Override + public Flux tables(KsqlRequest ksqlRequest) { + return webClient.post("/ksql", ksqlRequest, new TypeReference() { + }).flatMapMany(responses -> Flux.fromArray(responses)); + } + + private class QueryResponseMapper implements Function> { + private Map header; + + @Override + public Mono apply(QueryResponse queryResponse) { + if (queryResponse.getErrorMessage() != null) { + return Mono.error(new RuntimeException(queryResponse.getErrorMessage())); + } + + if (header == null) { + LOGGER.trace("Processing query headers."); + + header = queryResponse.getHeader(); + return Mono.empty(); + } + LOGGER.trace("Processing query row."); + + return Mono.just(new QueryRow(queryResponse.getRow())); + } + } + + private class WebSocketQueryResponseMapper implements Function> { + private boolean headerSkipped; + + @Override + public Mono apply(String value) { + LOGGER.trace("Processing websocket payload {}.", value); + + if (!headerSkipped) { + headerSkipped = true; + return Mono.empty(); + } else { + return Mono.just(JsonUtil.readValue(value, QueryRow.class)); + } + } + } + +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/JsonUtil.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/JsonUtil.java new file mode 100644 index 0000000..60af63d --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/JsonUtil.java @@ -0,0 +1,35 @@ +package dev.daniellavoie.ksqldb.client; + +import com.fasterxml.jackson.annotation.JsonInclude.Include; +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; + +public abstract class JsonUtil { + private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper().findAndRegisterModules() + .setSerializationInclusion(Include.NON_NULL); + + public static T readValue(String content, Class returnType) { + try { + return OBJECT_MAPPER.readValue(content, returnType); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + } + + public static T readValue(String content, TypeReference returnType) { + try { + return OBJECT_MAPPER.readValue(content, returnType); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + } + + public static String writeValueAsString(Object value) { + try { + return OBJECT_MAPPER.writeValueAsString(value); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBClient.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBClient.java new file mode 100644 index 0000000..a2ac2bd --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBClient.java @@ -0,0 +1,167 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +import dev.daniellavoie.ksqldb.client.api.info.HealthcheckResponse; +import dev.daniellavoie.ksqldb.client.api.info.InfoResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.CommandResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.DescribeResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.ExplainResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import dev.daniellavoie.ksqldb.client.api.ksql.PropertiesResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.QueriesResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.StreamsResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.TablesResponse; +import dev.daniellavoie.ksqldb.client.api.query.QueryRequest; +import dev.daniellavoie.ksqldb.client.model.QueryRow; +import reactor.core.publisher.Flux; +import reactor.core.publisher.Mono; + +/** + * Interface to interact with a ksqlDB Server. Provides access to all REST + * endpoints offered by a ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public interface KsqlDBClient { + static KsqlDBClient create(String ksqlDBUrl, String ksqlDBWebSocketUrl) { + return new DefaultKsqlDBClient(ksqlDBUrl, ksqlDBWebSocketUrl); + } + + /** + * Executes asynchronous DESCRIBE statement. + * + * @param ksqlRequest a request containing one or multiple DESCRIBE statement + * seperated by a ";". + * @return A {@link Flux} that emits a response for every query in the + * {@link KsqlRequest}. + */ + Flux describe(KsqlRequest ksqlRequest); + + /** + * Executes asynchronous SHOW STREAMS statement. + * + * @param ksqlRequest A request containing one or multiple SHOW STREAMS + * statement seperated by a ";". + * @return a {@link Flux} that emits a response for every statement in the + * {@link KsqlRequest}. + */ + Flux streams(KsqlRequest ksqlRequest); + + /** + * Executes asynchronous CREATE, DROP or TERMINATE statement. + * + * @param ksqlRequest a request containing one or multiple CREATE, DROP or + * TERMINATE statement seperated by a ";". + * @return a {@link Flux} that emits a response for every statement in the + * {@link KsqlRequest}. + */ + Flux execute(KsqlRequest ksqlRequest); + + /** + * Executes asynchronous EXPLAIN statement against a query. + * + * @param ksqlRequest a request containing one or multiple EXPLAIN statement + * seperated by a ";". + * @return a {@link Flux} that emits a response for every statement in the + * {@link KsqlRequest}. + */ + Flux explain(KsqlRequest ksqlRequest); + + /** + * Provides access to the {@link AdminUtil} embedded with the client. + * + * @return a {@link AdminUtil} + */ + AdminUtil getAdminUtil(); + + /** + * Executes an asynchronous health check request to the ksqlDB server. + * + * @return A {@link Mono} that emits an health check response when the request + * completes. + */ + Mono getHealthcheck(); + + /** + * Executes an asynchronous info request to the ksqlDB server. + * + * @return A {@link Mono} that emits an info response when the request + * completes. + */ + Mono getInfo(); + + /** + * Executes asynchronous SHOW PROPERTIES statement. + * + * @param ksqlRequest a request containing one or multiple SHOW PROPERTIES + * statement seperated by a ";". + * @return A {@link Flux} that emits a response for every statement in the + * {@link KsqlRequest}. + */ + Flux properties(KsqlRequest ksqlRequest); + + /** + * Executes asynchronous SHOW QUERIES statement. + * + * @param ksqlRequest a request containing one or multiple SHOW QUERIES + * statement seperated by a ";". + * @return A {@link Flux} that emits a response for every statement in the + * {@link KsqlRequest}. + */ + Flux queries(KsqlRequest ksqlRequest); + + /** + * Executes an asynchronous SELECT statement against a TABLE. The {@link Flux} + * return by the pull query will eventually send a complete signal as the server + * will handle this query as a request reply. The submitted SELECT STATEMENT + * should not contain EMIT CHANGES. See {@link pushQuery} for a push query that + * never ends. + * + * @param queryRequest a request containing a SELECT statement without EMIT + * CHANGES. + * @return a {@link Flux} that emits a {@link QueryRow} for every result from + * the query. Eventually sends a complete signal. + */ + Flux pullQuery(QueryRequest queryRequest); + + /** + * Executes an asynchronous SELECT statement against a TABLE. The {@link Flux} + * return by the push query will never send a complete signal as the server will + * handle this query as a push stream. The submitted SELECT STATEMENT should + * must contain EMIT CHANGES. See {@link pullQuery} for a pull query that acts a + * request reply. + * + * @param queryRequest a request containing a SELECT statement with EMIT + * CHANGES. + * @return a {@link Flux} that emits a {@link QueryRow} for every result from + * the query. Never sends a complete signal. + */ + Flux pushQuery(QueryRequest queryRequest); + + /** + * Executes asynchronous SHOW TABLES statement. + * + * @param ksqlRequest a request containing one or multiple SHOW TABLES statement + * seperated by a ";". + * @return A {@link Flux} that emits a response for every statement in the + * {@link KsqlRequest}. + */ + Flux tables(KsqlRequest ksqlRequest); +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBServerError.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBServerError.java new file mode 100644 index 0000000..d6fa3e5 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBServerError.java @@ -0,0 +1,80 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents an error returned by a ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class KsqlDBServerError { + private final String type; + private final int errorCode; + private final String message; + private final List stackTrace; + private final String statementText; + private final List entities; + + @JsonCreator + public KsqlDBServerError(@JsonProperty("@type") String type, @JsonProperty("error_code") int errorCode, + @JsonProperty("message") String message, @JsonProperty("stackTrace") List stackTrace, + @JsonProperty("statementText") String statementText, @JsonProperty("entities") List entities) { + this.type = type; + this.errorCode = errorCode; + this.message = message; + this.stackTrace = stackTrace; + this.statementText = statementText; + this.entities = entities; + } + + public String getType() { + return type; + } + + public int getErrorCode() { + return errorCode; + } + + public String getMessage() { + return message; + } + + public List getStackTrace() { + return stackTrace; + } + + public String getStatementText() { + return statementText; + } + + public List getEntities() { + return entities; + } + + @Override + public String toString() { + return "KsqlDBServerError [type=" + type + ", errorCode=" + errorCode + ", message=" + message + ", stackTrace=" + + stackTrace + ", statementText=" + statementText + ", entities=" + entities + "]"; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBServerException.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBServerException.java new file mode 100644 index 0000000..8cf9c3d --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/KsqlDBServerException.java @@ -0,0 +1,46 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +/** + * Exception that can propagate {@link KsqlDBServerError} returned from a ksqlDB + * server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class KsqlDBServerException extends RuntimeException { + private static final long serialVersionUID = 1L; + + private final KsqlDBServerError error; + + public KsqlDBServerException(KsqlDBServerError error) { + super(error.toString()); + + this.error = error; + } + + public KsqlDBServerError getError() { + return error; + } + + @Override + public String toString() { + return "KsqlDBServerException [error=" + error + "]"; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/ReactorWebClient.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/ReactorWebClient.java new file mode 100644 index 0000000..e9eeb4e --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/ReactorWebClient.java @@ -0,0 +1,175 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +import java.io.IOException; +import java.util.Map; +import java.util.Optional; +import java.util.stream.Collectors; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import com.fasterxml.jackson.core.JsonProcessingException; +import com.fasterxml.jackson.core.type.TypeReference; +import com.fasterxml.jackson.databind.ObjectMapper; + +import reactor.core.publisher.Flux; +import reactor.core.publisher.Mono; +import reactor.netty.ByteBufFlux; +import reactor.netty.http.client.HttpClient; + +/** + * Implementation of {@link WebClient} based on Reactor Netty. Contains specific + * handling for the /query endpoint of ksqlDB with EMIT CHANGES enabled. + * + * @author Daniel Lavoie + * + * @since 0.1.0 + * + */ +public class ReactorWebClient implements WebClient { + private static final Logger LOGGER = LoggerFactory.getLogger(ReactorWebClient.class); + + private String baseWebSocketUrl; + + private static final ObjectMapper OBJECTMAPPER = new ObjectMapper().findAndRegisterModules(); + private HttpClient client; + private HttpClient webSocketClient; + + public ReactorWebClient(String baseUrl, String baseWebSocketUrl) { + this.baseWebSocketUrl = baseWebSocketUrl; + client = HttpClient.create().baseUrl(baseUrl) + .headers(headerBuilder -> headerBuilder.add("Content-Type", "application/vnd.ksql.v1+json")); + + webSocketClient = HttpClient.create().baseUrl(baseWebSocketUrl); + } + + /** + * {@inheritDoc} + */ + @Override + public Mono get(String url, Class returnType) { + return client.get().uri(url).responseContent().aggregate().asString() + .map(value -> readValue(value, returnType)); + } + + @Override + public Flux getWithWebSocket(String url, Map params) { + String parameters = params.entrySet().stream() + + .map(entry -> URLEncoderUtil.encode(entry.getKey()) + "=" + URLEncoderUtil.encode(entry.getValue())) + + .collect(Collectors.joining("&")); + + return webSocketClient.websocket().uri(baseWebSocketUrl + url + "?" + parameters) + + .handle((inbound, outbound) -> inbound.receive().asString()); + } + + /** + * {@inheritDoc} + */ + @Override + public Mono post(String url, Object body, TypeReference returnType) { + return client.post().uri(url) + + .send(ByteBufFlux.fromString(Mono.just(writeValue(body)))) + + .responseContent().aggregate().asString().map(value -> readValue(value, returnType)); + } + + /** + * {@inheritDoc} + *

+ * Contains specific handing for the /query endpoint of ksqlDB. The server + * responds periodically with line breaks. This method skip those HTTP chunks + * and will only emits events when a proper JSON structure is received from the + * server within an HTTP chunk. + *

+ */ + @Override + public Flux postForMany(String url, Object body, TypeReference returnType) { + return client.post().uri(url).send(ByteBufFlux.fromString(Mono.just(writeValue(body)))) + + .responseContent().asString().map(value -> readStreamValue(value, returnType)) + + .filter(Optional::isPresent) + + .map(Optional::get); + } + + private T readValue(String value, TypeReference returnType) { + try { + return OBJECTMAPPER.readValue(value, returnType); + } catch (IOException e) { + try { + throw new KsqlDBServerException(OBJECTMAPPER.readValue(value, KsqlDBServerError.class)); + } catch (IOException e2) { + LOGGER.error("Failed to read {}.", value); + throw new RuntimeException(e); + } + } + } + + private T readValue(String value, Class returnType) { + try { + return OBJECTMAPPER.readValue(value, returnType); + } catch (IOException e) { + try { + throw new KsqlDBServerException(OBJECTMAPPER.readValue(value, KsqlDBServerError.class)); + } catch (IOException e2) { + LOGGER.error("Failed to read {}.", value); + throw new RuntimeException(e); + } + } + } + + private Optional readStreamValue(String value, TypeReference returnType) { + LOGGER.trace("Received payload {}.", value); + + try { + if (value.equals(",\n") || value.equals("\n")) { + return Optional.empty(); + } + + if (value.startsWith("[") && !value.endsWith("]")) { + value = value.substring(1); + } + + if (!value.startsWith("[") && value.endsWith("]")) { + value = value.substring(0, value.length()); + } + + if (value.endsWith(",")) { + value = value.substring(0, value.length()); + } + + return Optional.of(OBJECTMAPPER.readValue(value, returnType)); + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + private String writeValue(Object value) { + try { + return OBJECTMAPPER.writeValueAsString(value); + } catch (JsonProcessingException e) { + throw new RuntimeException(e); + } + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/RowExtractor.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/RowExtractor.java new file mode 100644 index 0000000..9b72c46 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/RowExtractor.java @@ -0,0 +1,14 @@ +package dev.daniellavoie.ksqldb.client; + +import java.util.Optional; + +import dev.daniellavoie.ksqldb.client.api.query.Row; + +public class RowExtractor implements ValueExtractor { + + @Override + public Optional extractValue(String value) { + throw new UnsupportedOperationException("Not implemented yet"); + } + +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/URLEncoderUtil.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/URLEncoderUtil.java new file mode 100644 index 0000000..c14d8c1 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/URLEncoderUtil.java @@ -0,0 +1,19 @@ +package dev.daniellavoie.ksqldb.client; + +import java.io.UnsupportedEncodingException; +import java.net.URLEncoder; +import java.nio.charset.StandardCharsets; + +public abstract class URLEncoderUtil { + public static String encode(String value) { + return URLEncoderUtil.encode(value, StandardCharsets.UTF_8.toString()); + } + + public static String encode(String value, String enc) { + try { + return URLEncoder.encode(value, enc); + } catch (UnsupportedEncodingException e) { + throw new RuntimeException(e); + } + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/ValueExtractor.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/ValueExtractor.java new file mode 100644 index 0000000..db1a05f --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/ValueExtractor.java @@ -0,0 +1,7 @@ +package dev.daniellavoie.ksqldb.client; + +import java.util.Optional; + +public interface ValueExtractor { + Optional extractValue(String value); +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/ValueFormat.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/ValueFormat.java new file mode 100644 index 0000000..e73e280 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/ValueFormat.java @@ -0,0 +1,5 @@ +package dev.daniellavoie.ksqldb.client; + +public enum ValueFormat { + AVRO, JSON +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/WebClient.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/WebClient.java new file mode 100644 index 0000000..9bc796a --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/WebClient.java @@ -0,0 +1,72 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client; + +import java.util.Map; + +import com.fasterxml.jackson.core.type.TypeReference; + +import reactor.core.publisher.Flux; +import reactor.core.publisher.Mono; + +/** + * + * Reactive interface to interact with a rest endpoint. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public interface WebClient { + /** + * Executes a GET HTTP request that emits a single response. + * + * @param Typed object matching the response body. + * @param url URL for the GET request + * @param returnType Class instance of the type to be emitted. + * @return Deserialized response content + */ + Mono get(String url, Class returnType); + + Flux getWithWebSocket(String url, Map params); + + /** + * Executes a POST HTTP request that emits a single response. + * + * @param A typed object matching the response body. + * @param url URL for the POST request + * @param body Object to be serialized as the POST request body + * @param returnType Class instance of the type to be emitted. + * @return A {@link Mono} that emits an event when + */ + Mono post(String url, Object body, TypeReference returnType); + + /** + * Executes a POST HTTP request that emits multiple typed events until a final + * completion signal is sent. + * + * @param A typed object matching the response body that are emitted + * until completion. + * @param url URL for the POST request + * @param body Object to be serialized as the POST request body + * @param returnType Class instance of the type to be emitted. + * @return A {@link Flux} that emits an event for each HTTP chunk received by + * the client. + */ + Flux postForMany(String url, Object body, TypeReference returnType); + +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Details.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Details.java new file mode 100644 index 0000000..415aa7a --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Details.java @@ -0,0 +1,46 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.info; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents the server details from a health check query to a ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class Details { + private final Metastore metastore; + private final Kafka kafka; + + @JsonCreator + public Details(@JsonProperty("metastore") Metastore metastore, @JsonProperty("kafka") Kafka kafka) { + this.metastore = metastore; + this.kafka = kafka; + } + + public Metastore getMetastore() { + return metastore; + } + + public Kafka getKafka() { + return kafka; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/HealthcheckResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/HealthcheckResponse.java new file mode 100644 index 0000000..a700a29 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/HealthcheckResponse.java @@ -0,0 +1,46 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.info; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents a response from an health check query to a ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class HealthcheckResponse { + private final boolean healthy; + private final Details details; + + @JsonCreator + public HealthcheckResponse(@JsonProperty("isHealthy") boolean healthy, @JsonProperty("details") Details details) { + this.healthy = healthy; + this.details = details; + } + + public boolean isHealthy() { + return healthy; + } + + public Details getDetails() { + return details; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/InfoResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/InfoResponse.java new file mode 100644 index 0000000..faa2b59 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/InfoResponse.java @@ -0,0 +1,40 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.info; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents the response from an info request to a ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class InfoResponse { + private final KsqlServerInfo ksqlServerInfo; + + @JsonCreator + public InfoResponse(@JsonProperty("KsqlServerInfo") KsqlServerInfo ksqlServerInfo) { + this.ksqlServerInfo = ksqlServerInfo; + } + + public KsqlServerInfo getKsqlServerInfo() { + return ksqlServerInfo; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Kafka.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Kafka.java new file mode 100644 index 0000000..45f8d17 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Kafka.java @@ -0,0 +1,40 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.info; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents a Kafka health check response from an health check query to a + * ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + */ +public class Kafka { + private final boolean healthy; + + @JsonCreator + public Kafka(@JsonProperty("isHealthy") boolean healthy) { + this.healthy = healthy; + } + + public boolean isHealthy() { + return healthy; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/KsqlServerInfo.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/KsqlServerInfo.java new file mode 100644 index 0000000..b9bdde5 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/KsqlServerInfo.java @@ -0,0 +1,54 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.info; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents the server details returned from a ksqlDB info query. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class KsqlServerInfo { + private final String version; + private final String kafkaClusterId; + private final String ksqlServiceId; + + @JsonCreator + public KsqlServerInfo(@JsonProperty("version") String version, + @JsonProperty("kafkaClusterId") String kafkaClusterId, + @JsonProperty("ksqlServiceId") String ksqlServiceId) { + this.version = version; + this.kafkaClusterId = kafkaClusterId; + this.ksqlServiceId = ksqlServiceId; + } + + public String getVersion() { + return version; + } + + public String getKafkaClusterId() { + return kafkaClusterId; + } + + public String getKsqlServiceId() { + return ksqlServiceId; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Metastore.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Metastore.java new file mode 100644 index 0000000..e752ce4 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/info/Metastore.java @@ -0,0 +1,40 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.info; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents a Metastore returned by a ksqlDB server from a Health check query. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class Metastore { + private final boolean healthy; + + @JsonCreator + public Metastore(@JsonProperty("isHealthy") boolean healthy) { + this.healthy = healthy; + } + + public boolean isHealthy() { + return healthy; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/CommandResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/CommandResponse.java new file mode 100644 index 0000000..f7f1134 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/CommandResponse.java @@ -0,0 +1,52 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class CommandResponse extends KsqlResponse { + private final String commandId; + private final CommandStatus commandStatus; + private final long commandSequenceNumber; + + @JsonCreator + public CommandResponse(@JsonProperty("@type") String type, @JsonProperty("error_code") Integer errorCode, + @JsonProperty("statementText") String statementText, @JsonProperty("warnings") List warnings, + @JsonProperty("commandId") String commandId, @JsonProperty("commandStatus") CommandStatus commandStatus, + @JsonProperty("commandSequenceNumber") long commandSequenceNumber) { + super(type, errorCode, statementText, warnings); + + this.commandId = commandId; + this.commandStatus = commandStatus; + this.commandSequenceNumber = commandSequenceNumber; + } + + public String getCommandId() { + return commandId; + } + + public CommandStatus getCommandStatus() { + return commandStatus; + } + + public long getCommandSequenceNumber() { + return commandSequenceNumber; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/CommandStatus.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/CommandStatus.java new file mode 100644 index 0000000..a805e30 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/CommandStatus.java @@ -0,0 +1,39 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class CommandStatus { + private final String status; + private final String message; + + @JsonCreator + public CommandStatus(@JsonProperty("status") String status, @JsonProperty("message") String message) { + this.status = status; + this.message = message; + } + + public String getStatus() { + return status; + } + + public String getMessage() { + return message; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/DescribeResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/DescribeResponse.java new file mode 100644 index 0000000..6ffa34f --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/DescribeResponse.java @@ -0,0 +1,43 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class DescribeResponse extends KsqlResponse { + public enum SourceType { + STREAM, TABLE + } + + private final SourceDescription sourceDescription; + + @JsonCreator + public DescribeResponse(@JsonProperty("@type") String type, @JsonProperty("error_code") Integer errorCode, + @JsonProperty("statementText") String statementText, @JsonProperty("warnings") List warnings, + @JsonProperty("sourceDescription") SourceDescription sourceDescription) { + super(type, errorCode, statementText, warnings); + + this.sourceDescription = sourceDescription; + } + + public SourceDescription getSourceDescription() { + return sourceDescription; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/ExplainResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/ExplainResponse.java new file mode 100644 index 0000000..e5e97cb --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/ExplainResponse.java @@ -0,0 +1,39 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class ExplainResponse extends KsqlResponse { + private final QueryDescription queryDescription; + + @JsonCreator + public ExplainResponse(@JsonProperty("@type") String type, @JsonProperty("error_code") Integer errorCode, + @JsonProperty("statementText") String statementText, @JsonProperty("warnings") List warnings, + @JsonProperty("queryDescription") QueryDescription queryDescription) { + super(type, errorCode, statementText, warnings); + + this.queryDescription = queryDescription; + } + + public QueryDescription getQueryDescription() { + return queryDescription; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Field.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Field.java new file mode 100644 index 0000000..ff4fd85 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Field.java @@ -0,0 +1,39 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class Field { + private final String name; + private final Schema schema; + + @JsonCreator + public Field(@JsonProperty("name") String name, @JsonProperty("schema") Schema schema) { + this.name = name; + this.schema = schema; + } + + public String getName() { + return name; + } + + public Schema getSchema() { + return schema; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Format.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Format.java new file mode 100644 index 0000000..761ce7a --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Format.java @@ -0,0 +1,21 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +public enum Format { + AVRO, DELIMITED, JSON +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/KsqlRequest.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/KsqlRequest.java new file mode 100644 index 0000000..51fe9bd --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/KsqlRequest.java @@ -0,0 +1,48 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.Map; + +public class KsqlRequest { + private final String ksql; + private final Map streamsProperties; + private final Long commandSequenceNumber; + + public KsqlRequest(String ksql) { + this(ksql, null, null); + } + + public KsqlRequest(String ksql, Map streamsProperties, Long commandSequenceNumber) { + this.ksql = ksql; + this.streamsProperties = streamsProperties; + this.commandSequenceNumber = commandSequenceNumber; + } + + public String getKsql() { + return ksql; + } + + public Map getStreamsProperties() { + return streamsProperties; + } + + public Long getCommandSequenceNumber() { + return commandSequenceNumber; + } + +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/KsqlResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/KsqlResponse.java new file mode 100644 index 0000000..0e3f019 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/KsqlResponse.java @@ -0,0 +1,51 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +public abstract class KsqlResponse { + private final String type; + private final Integer errorCode; + private final String statementText; + private final List warnings; + + public KsqlResponse(String type, Integer errorCode, String statementText, List warnings) { + this.type = type; + this.errorCode = errorCode; + this.statementText = statementText; + this.warnings = warnings; + } + + public String getType() { + return type; + } + + public Integer getErrorCode() { + return errorCode; + } + + public String getStatementText() { + return statementText; + } + + public List getWarnings() { + return warnings; + } + + +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Options.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Options.java new file mode 100644 index 0000000..d53db3a --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Options.java @@ -0,0 +1,37 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.Map; + +public class Options { + private final Map streamsProperties; + private final Long commandSequenceNumber; + + public Options(Map streamsProperties, Long commandSequenceNumber) { + this.streamsProperties = streamsProperties; + this.commandSequenceNumber = commandSequenceNumber; + } + + public Map getStreamsProperties() { + return streamsProperties; + } + + public Long getCommandSequenceNumber() { + return commandSequenceNumber; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/PropertiesResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/PropertiesResponse.java new file mode 100644 index 0000000..1d513e5 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/PropertiesResponse.java @@ -0,0 +1,54 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class PropertiesResponse extends KsqlResponse { + private final Map properties; + private final List overwrittenProperties; + private final List defaultProperties; + + @JsonCreator + public PropertiesResponse(@JsonProperty("@type") String type, @JsonProperty("error_code") Integer errorCode, + @JsonProperty("statementText") String statementText, @JsonProperty("warnings") List warnings, + @JsonProperty("properties") Map properties, + @JsonProperty("overwrittenProperties") List overwrittenProperties, + @JsonProperty("defaultProperties") List defaultProperties) { + super(type, errorCode, statementText, warnings); + + this.properties = properties; + this.overwrittenProperties = overwrittenProperties; + this.defaultProperties = defaultProperties; + } + + public Map getProperties() { + return properties; + } + + public List getOverwrittenProperties() { + return overwrittenProperties; + } + + public List getDefaultProperties() { + return defaultProperties; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/QueriesResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/QueriesResponse.java new file mode 100644 index 0000000..95d3464 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/QueriesResponse.java @@ -0,0 +1,39 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class QueriesResponse extends KsqlResponse { + private final List queries; + + @JsonCreator + public QueriesResponse(@JsonProperty("@type") String type, @JsonProperty("error_code") Integer errorCode, + @JsonProperty("statementText") String statementText, @JsonProperty("warnings") List warnings, + @JsonProperty("queries") List queries) { + super(type, errorCode, statementText, warnings); + + this.queries = queries; + } + + public List getQueries() { + return queries; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Query.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Query.java new file mode 100644 index 0000000..8ba38f4 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Query.java @@ -0,0 +1,48 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class Query { + private final String queryString; + private final List sinks; + private final String id; + + @JsonCreator + public Query(@JsonProperty("queryString") String queryString, @JsonProperty("sinks") List sinks, + @JsonProperty("id") String id) { + this.queryString = queryString; + this.sinks = sinks; + this.id = id; + } + + public String getQueryString() { + return queryString; + } + + public List getSinks() { + return sinks; + } + + public String getId() { + return id; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/QueryDescription.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/QueryDescription.java new file mode 100644 index 0000000..f97d20d --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/QueryDescription.java @@ -0,0 +1,88 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class QueryDescription { + private final String id; + private final String state; + private final String statementText; + private final List fields; + private final List sources; + private final List sinks; + private final String executionPlan; + private final String topology; + private final Map overriddenProperties; + + @JsonCreator + public QueryDescription(@JsonProperty("id") String id, @JsonProperty("state") String state, + @JsonProperty("statementText") String statementText, @JsonProperty("fields") List fields, + @JsonProperty("sources") List sources, @JsonProperty("sinks") List sinks, + @JsonProperty("executionPlan") String executionPlan, @JsonProperty("topology") String topology, + @JsonProperty("overriddenProperties") Map overriddenProperties) { + this.id = id; + this.state = state; + this.statementText = statementText; + this.fields = fields; + this.sources = sources; + this.sinks = sinks; + this.executionPlan = executionPlan; + this.topology = topology; + this.overriddenProperties = overriddenProperties; + } + + public String getId() { + return id; + } + + public String getState() { + return state; + } + + public String getStatementText() { + return statementText; + } + + public List getFields() { + return fields; + } + + public List getSources() { + return sources; + } + + public List getSinks() { + return sinks; + } + + public String getExecutionPlan() { + return executionPlan; + } + + public String getTopology() { + return topology; + } + + public Map getOverriddenProperties() { + return overriddenProperties; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Schema.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Schema.java new file mode 100644 index 0000000..e70ff43 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Schema.java @@ -0,0 +1,48 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class Schema { + private final String type; + private final Schema memberSchema; + private final List fields; + + @JsonCreator + public Schema(@JsonProperty("type") String type, @JsonProperty("memberSchema") Schema memberSchema, + @JsonProperty("fields") List fields) { + this.type = type; + this.memberSchema = memberSchema; + this.fields = fields; + } + + public String getType() { + return type; + } + + public Schema getMemberSchema() { + return memberSchema; + } + + public List getFields() { + return fields; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/SourceDescription.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/SourceDescription.java new file mode 100644 index 0000000..6b7fdd0 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/SourceDescription.java @@ -0,0 +1,121 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +import dev.daniellavoie.ksqldb.client.api.ksql.DescribeResponse.SourceType; + +public class SourceDescription { + private final String name; + private final List readQueries; + private final List writeQueries; + private final List fields; + private final SourceType type; + private final String key; + private final String timestamp; + private final Format format; + private final String topic; + private final boolean extended; + private final String statistics; + private final String errorStats; + private final int replication; + private final int partitions; + + @JsonCreator + public SourceDescription(@JsonProperty("name") String name, @JsonProperty("readQueries") List readQueries, + @JsonProperty("writeQueries") List writeQueries, @JsonProperty("fields") List fields, + @JsonProperty("type") SourceType type, @JsonProperty("key") String key, + @JsonProperty("timestamp") String timestamp, @JsonProperty("format") Format format, + @JsonProperty("topic") String topic, @JsonProperty("extended") boolean extended, + @JsonProperty("statistics") String statistics, @JsonProperty("errorStats") String errorStats, + @JsonProperty("replication") int replication, @JsonProperty("partitions") int partitions) { + this.name = name; + this.readQueries = readQueries; + this.writeQueries = writeQueries; + this.fields = fields; + this.type = type; + this.key = key; + this.timestamp = timestamp; + this.format = format; + this.topic = topic; + this.extended = extended; + this.statistics = statistics; + this.errorStats = errorStats; + this.replication = replication; + this.partitions = partitions; + } + + public String getName() { + return name; + } + + public List getReadQueries() { + return readQueries; + } + + public List getWriteQueries() { + return writeQueries; + } + + public List getFields() { + return fields; + } + + public SourceType getType() { + return type; + } + + public String getKey() { + return key; + } + + public String getTimestamp() { + return timestamp; + } + + public Format getFormat() { + return format; + } + + public String getTopic() { + return topic; + } + + public boolean isExtended() { + return extended; + } + + public String getStatistics() { + return statistics; + } + + public String getErrorStats() { + return errorStats; + } + + public int getReplication() { + return replication; + } + + public int getPartitions() { + return partitions; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Stream.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Stream.java new file mode 100644 index 0000000..b81f46d --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Stream.java @@ -0,0 +1,56 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class Stream { + public enum Type { + STREAM + } + + private final String name; + private final String topic; + private final Format format; + private final Type type; + + @JsonCreator + public Stream(@JsonProperty("name") String name, @JsonProperty("topic") String topic, + @JsonProperty("format") Format format, @JsonProperty("type") Type type) { + this.name = name; + this.topic = topic; + this.format = format; + this.type = type; + } + + public String getName() { + return name; + } + + public String getTopic() { + return topic; + } + + public Format getFormat() { + return format; + } + + public Type getType() { + return type; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/StreamsResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/StreamsResponse.java new file mode 100644 index 0000000..4855e00 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/StreamsResponse.java @@ -0,0 +1,38 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class StreamsResponse extends KsqlResponse { + private final List streams; + + @JsonCreator + public StreamsResponse(@JsonProperty("@type") String type, @JsonProperty("error_code") Integer errorCode, @JsonProperty("statementText") String statementText, + @JsonProperty("warnings") List warnings, @JsonProperty("streams") List streams) { + super(type, errorCode, statementText, warnings); + + this.streams = streams; + } + + public List getStreams() { + return streams; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Table.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Table.java new file mode 100644 index 0000000..aa55fe4 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Table.java @@ -0,0 +1,63 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class Table { + public enum Type { + TABLE + } + + private final String name; + private final String topic; + private final Format format; + private final Type type; + private final boolean windowed; + + @JsonCreator + public Table(@JsonProperty("name") String name, @JsonProperty("topic") String topic, + @JsonProperty("format") Format format, @JsonProperty("type") Type type, + @JsonProperty("isWindowed") boolean windowed) { + this.name = name; + this.topic = topic; + this.format = format; + this.type = type; + this.windowed = windowed; + } + + public String getName() { + return name; + } + + public String getTopic() { + return topic; + } + + public Format getFormat() { + return format; + } + + public Type getType() { + return type; + } + + public boolean isWindowed() { + return windowed; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/TablesResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/TablesResponse.java new file mode 100644 index 0000000..ed6ced5 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/TablesResponse.java @@ -0,0 +1,40 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class TablesResponse extends KsqlResponse { + + private final List tables; + + @JsonCreator + public TablesResponse(@JsonProperty("@type") String type, @JsonProperty("error_code") Integer errorCode, + @JsonProperty("statementText") String statementText, @JsonProperty("warnings") List warnings, + @JsonProperty("tables") List
tables) { + super(type, errorCode, statementText, warnings); + + this.tables = tables; + } + + public List
getTables() { + return tables; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Warning.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Warning.java new file mode 100644 index 0000000..32e9a58 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/ksql/Warning.java @@ -0,0 +1,33 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.ksql; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class Warning { + private final String message; + + @JsonCreator + public Warning(@JsonProperty("message") String message) { + this.message = message; + } + + public String getMessage() { + return message; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/QueryRequest.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/QueryRequest.java new file mode 100644 index 0000000..9ea088f --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/QueryRequest.java @@ -0,0 +1,48 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.query; + +import java.util.Map; + +/** + * Represents a Query request made to the query endpoint of a ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class QueryRequest { + private final String ksql; + private final Map streamsProperties; + + public QueryRequest(String ksql) { + this(ksql, null); + } + + public QueryRequest(String ksql, Map streamsProperties) { + this.ksql = ksql; + this.streamsProperties = streamsProperties; + } + + public String getKsql() { + return ksql; + } + + public Map getStreamsProperties() { + return streamsProperties; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/QueryResponse.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/QueryResponse.java new file mode 100644 index 0000000..5533ff7 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/QueryResponse.java @@ -0,0 +1,54 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.query; + +import java.util.Map; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents a response returned from a query request to ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + */ +public class QueryResponse { + private final Map header; + private final Row row; + private final String errorMessage; + + @JsonCreator + public QueryResponse(@JsonProperty("header") Map header, @JsonProperty("row") Row row, + @JsonProperty("errorMessage") String errorMessage) { + this.header = header; + this.row = row; + this.errorMessage = errorMessage; + } + + public Map getHeader() { + return header; + } + + public Row getRow() { + return row; + } + + public String getErrorMessage() { + return errorMessage; + } +} diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/Row.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/Row.java new file mode 100644 index 0000000..492d854 --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/api/query/Row.java @@ -0,0 +1,42 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.api.query; + +import java.util.List; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +/** + * Represents a Row field from a query response returned by a ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class Row { + private final List columns; + + @JsonCreator + public Row(@JsonProperty("columns") List columns) { + this.columns = columns; + } + + public List getColumns() { + return columns; + } +} \ No newline at end of file diff --git a/client/src/main/java/dev/daniellavoie/ksqldb/client/model/QueryRow.java b/client/src/main/java/dev/daniellavoie/ksqldb/client/model/QueryRow.java new file mode 100644 index 0000000..b778b5a --- /dev/null +++ b/client/src/main/java/dev/daniellavoie/ksqldb/client/model/QueryRow.java @@ -0,0 +1,43 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.model; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +import dev.daniellavoie.ksqldb.client.api.query.Row; + +/** + * Represents an aggregation of the initial headers received from a query + * response joined with a row from each response of the ksqlDB server. + * + * @author Daniel Lavoie + * @since 0.1.0 + * + */ +public class QueryRow { + private final Row row; + + @JsonCreator + public QueryRow(@JsonProperty("row") Row row) { + this.row = row; + } + + public Row getRow() { + return row; + } +} diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..66660af --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,133 @@ +--- +version: '2' +services: + zookeeper: + image: confluentinc/cp-zookeeper:5.3.1 + container_name: ksqldb-client-zookeeper + environment: + ZOOKEEPER_CLIENT_PORT: 2181 + ZOOKEEPER_TICK_TIME: 2000 + + kafka: + image: confluentinc/cp-kafka:5.3.1 + container_name: ksqldb-client-kafka + depends_on: + - zookeeper + ports: + - 9092:9092 + - 19092:19092 + environment: + KAFKA_BROKER_ID: 1 + KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181 + KAFKA_ADVERTISED_LISTENERS: LOCALHOST://localhost:9092,DOCKER://kafka:19092 + KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: LOCALHOST:PLAINTEXT,DOCKER:PLAINTEXT + KAFKA_INTER_BROKER_LISTENER_NAME: DOCKER + KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1 + + schema-registry: + image: confluentinc/cp-schema-registry:5.3.1 + container_name: ksqldb-client-schema-registry + restart: always + depends_on: + - kafka + - zookeeper + ports: + - 8085:8085 + environment: + SCHEMA_REGISTRY_KAFKASTORE_BOOTSTRAP_SERVERS: kafka:19092 + SCHEMA_REGISTRY_HOST_NAME: schema-registry + SCHEMA_REGISTRY_LISTENERS: http://schema-registry:8085 + + connect: + image: confluentinc/cp-kafka-connect:5.3.1 + container_name: ksqldb-client-connect + restart: always + ports: + - "8083:8083" + depends_on: + - zookeeper + - kafka + - schema-registry + volumes: + - ./connectors:/connect-plugins + - ./connect-libs/mssql-jdbc-7.2.2.jre8.jar:/usr/share/java/kafka-connect-jdbc/mssql-jdbc-7.2.2.jre8.jar + - ./connect-libs/mysql-connector-java-8.0.13.jar:/usr/share/java/kafka-connect-jdbc/mysql-connector-java-8.0.13.jar + environment: + CONNECT_BOOTSTRAP_SERVERS: "kafka:19092" + CONNECT_REST_PORT: 8083 + CONNECT_LISTENERS: "http://0.0.0.0:8083" + CONNECT_GROUP_ID: "connect" + CONNECT_PRODUCER_CLIENT_ID: "connect-worker-producer" + CONNECT_CONFIG_STORAGE_TOPIC: connect-configs + CONNECT_OFFSET_STORAGE_TOPIC: connect-offsets + CONNECT_STATUS_STORAGE_TOPIC: connect-statuses + CONNECT_REPLICATION_FACTOR: 1 + CONNECT_CONFIG_STORAGE_REPLICATION_FACTOR: 1 + CONNECT_OFFSET_STORAGE_REPLICATION_FACTOR: 1 + CONNECT_STATUS_STORAGE_REPLICATION_FACTOR: 1 + CONNECT_KEY_CONVERTER: org.apache.kafka.connect.storage.StringConverter + CONNECT_VALUE_CONVERTER: org.apache.kafka.connect.json.JsonConverter + CONNECT_INTERNAL_KEY_CONVERTER: "org.apache.kafka.connect.json.JsonConverter" + CONNECT_INTERNAL_VALUE_CONVERTER: "org.apache.kafka.connect.json.JsonConverter" + CONNECT_REST_ADVERTISED_HOST_NAME: "connect" + CONNECT_PLUGIN_PATH: "/usr/share/java,/connect-plugins" + CONNECT_LOG4J_ROOT_LOGLEVEL: INFO + CONNECT_LOG4J_LOGGERS: org.reflections=ERROR + CLASSPATH: /usr/share/java/monitoring-interceptors/monitoring-interceptors-5.3.1.jar + + control-center: + image: confluentinc/cp-enterprise-control-center:5.3.1 + container_name: ksqldb-client-control-center + restart: always + depends_on: + - zookeeper + - kafka + - connect + ports: + - "9021:9021" + environment: + CONTROL_CENTER_BOOTSTRAP_SERVERS: "kafka:19092" + CONTROL_CENTER_ZOOKEEPER_CONNECT: "zookeeper:2181" + CONTROL_CENTER_REPLICATION_FACTOR: 1 + CONTROL_CENTER_MONITORING_INTERCEPTOR_TOPIC_REPLICATION: 1 + CONTROL_CENTER_INTERNAL_TOPICS_REPLICATION: 1 + CONTROL_CENTER_COMMAND_TOPIC_REPLICATION: 1 + CONTROL_CENTER_METRICS_TOPIC_REPLICATION: 1 + CONTROL_CENTER_MONITORING_INTERCEPTOR_TOPIC_PARTITIONS: 1 + CONTROL_CENTER_INTERNAL_TOPICS_PARTITIONS: 1 + CONTROL_CENTER_METRICS_TOPIC_PARTITIONS: 1 + CONTROL_CENTER_STREAMS_NUM_STREAM_THREADS: 1 + # Amount of heap to use for internal caches. Increase for better thoughput + CONTROL_CENTER_STREAMS_CACHE_MAX_BYTES_BUFFERING: 100000000 + CONTROL_CENTER_CONNECT_CLUSTER: "http://connect:8083" + CONTROL_CENTER_KSQL_URL: "http://ksqldb:8088" + CONTROL_CENTER_KSQL_ADVERTISED_URL: "http://ksqldb:8088" + CONTROL_CENTER_SCHEMA_REGISTRY_URL: "http://schema-registry:8085" + CONTROL_CENTER_DEPRECATED_VIEWS_ENABLE: "true" + CONTROL_CENTER_STREAMS_CONSUMER_REQUEST_TIMEOUT_MS: "960032" + # HTTP and HTTPS to Control Center UI + CONTROL_CENTER_REST_LISTENERS: "http://0.0.0.0:9021" + + ksqldb: + image: confluentinc/ksqldb-server:0.6.0 + hostname: ksqldb + container_name: ksqldb-client-server + depends_on: + - kafka + ports: + - "8088:8088" + environment: + KSQL_LISTENERS: http://0.0.0.0:8088 + KSQL_BOOTSTRAP_SERVERS: kafka:19092 + KSQL_KSQL_SCHEMA_REGISTRY_URL: "http://schema-registry:8085" + KSQL_KSQL_LOGGING_PROCESSING_STREAM_AUTO_CREATE: "true" + KSQL_KSQL_LOGGING_PROCESSING_TOPIC_AUTO_CREATE: "true" + + ksqldb-cli: + image: confluentinc/ksqldb-cli:0.6.0 + container_name: ksqldb-client-cli + depends_on: + - kafka + - ksqldb + entrypoint: /bin/sh + tty: true \ No newline at end of file diff --git a/integration-tests/.gitignore b/integration-tests/.gitignore new file mode 100644 index 0000000..beef00d --- /dev/null +++ b/integration-tests/.gitignore @@ -0,0 +1,4 @@ +.classpath +.project +.settings +target diff --git a/integration-tests/pom.xml b/integration-tests/pom.xml new file mode 100644 index 0000000..a08d063 --- /dev/null +++ b/integration-tests/pom.xml @@ -0,0 +1,53 @@ + + + 4.0.0 + + dev.daniellavoie.ksqldb + ksqldb-java-client-parent + 0.2.0-SNAPSHOT + .. + + + ksqldb-java-client-tests + + Non-Blocking Reactive Java Client for ksqlDB - Integration Tests + Non-Blocking Reactive Java Client for ksqlDB - Integration Tests + + + 1.8 + 1.8 + + + + + + org.springframework.boot + spring-boot-dependencies + 2.2.2.RELEASE + pom + import + + + + + + + org.springframework.boot + spring-boot-starter-webflux + + + org.springframework.boot + spring-boot-starter-test + test + + + org.springframework.kafka + spring-kafka + + + + dev.daniellavoie.ksqldb + ksqldb-java-client + + + diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/EndpointTest.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/EndpointTest.java new file mode 100644 index 0000000..dbe51f5 --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/EndpointTest.java @@ -0,0 +1,151 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests; + +import java.time.Duration; +import java.util.Arrays; + +import org.apache.kafka.clients.admin.AdminClient; +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.BeforeEach; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.autoconfigure.kafka.KafkaProperties; +import org.springframework.boot.test.context.SpringBootTest; + +import dev.daniellavoie.ksqldb.client.ColumnDefinition; +import dev.daniellavoie.ksqldb.client.DataType; +import dev.daniellavoie.ksqldb.client.KsqlDBClient; +import dev.daniellavoie.ksqldb.client.KsqlDBServerException; +import dev.daniellavoie.ksqldb.client.ValueFormat; +import dev.daniellavoie.ksqldb.client.api.ksql.CommandResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import dev.daniellavoie.ksqldb.client.api.ksql.Query; +import dev.daniellavoie.ksqldb.client.tests.kafka.KafkaUtil; +import reactor.core.publisher.Flux; +import reactor.core.publisher.Mono; + +@SpringBootTest +public abstract class EndpointTest { + private static final Logger LOGGER = LoggerFactory.getLogger(EndpointTest.class); + + protected static String TOPIC_NAME = "kafka-java-client-transaction"; + protected static String TABLE_NAME = "KAFKA_JAVA_CLIENT_TRANSACTION_STATS"; + protected static String STREAM_NAME = "KAFKA_JAVA_CLIENT_TRANSACTION_STREAM"; + + @Autowired + protected KafkaProperties kafkaProperties; + + @Autowired + private AdminClient adminClient; + + @Autowired + protected KsqlDBClient ksqlDBClient; + + protected String lastQueryId; + + protected Flux getQueries() { + return ksqlDBClient.queries(new KsqlRequest("SHOW QUERIES;")) + .flatMapIterable(response -> response.getQueries()); + } + + private void cleanQueries() { + getQueries() + + .flatMap(query -> ksqlDBClient.execute(new KsqlRequest("TERMINATE " + query.getId() + ";"))) + + .blockLast(); + } + + @BeforeEach + public void cleanTableAndStream() { + cleanQueries(); + + // Drop stream if it exists. + try { + CommandResponse response = ksqlDBClient + .execute(new KsqlRequest("DROP STREAM IF EXISTS " + STREAM_NAME + ";")).blockFirst(); + + Assertions.assertNotNull(response); + } catch (KsqlDBServerException serverEx) { + LOGGER.info("Failed to delete stream " + STREAM_NAME + ".", serverEx); + } + + // Drop table if it exists. + try { + CommandResponse response = ksqlDBClient.execute(new KsqlRequest("DROP TABLE IF EXISTS " + TABLE_NAME + ";")) + .blockFirst(); + + Assertions.assertNotNull(response); + } catch (KsqlDBServerException serverEx) { + LOGGER.info("Failed to delete stream " + STREAM_NAME + ".", serverEx); + } + + KafkaUtil.createTopicIfMissing(TOPIC_NAME, adminClient); + + ksqlDBClient.getAdminUtil() + .createStreamIfMissing(STREAM_NAME, TOPIC_NAME, ValueFormat.JSON, + Arrays.asList(new ColumnDefinition("account", DataType.STRING.toString()), + new ColumnDefinition("creditCurrency", DataType.STRING.toString()), + new ColumnDefinition("creditAmount", DataType.DOUBLE.toString()), + new ColumnDefinition("debitCurrency", DataType.STRING.toString()), + new ColumnDefinition("debitAmount", DataType.DOUBLE.toString()), + new ColumnDefinition("timestamp", DataType.ARRAY + "<" + DataType.INTEGER + ">"))) + .block(); + + execute("CREATE TABLE " + TABLE_NAME + " AS SELECT account, count(1) transactionCount FROM " + STREAM_NAME + + " GROUP BY account;"); + + lastQueryId = getQueries().blockFirst().getId(); + + } + + protected CommandResponse execute(String ksqlStatement) { + KsqlRequest ksqlTableRequest = new KsqlRequest(ksqlStatement); + + CommandResponse response = ksqlDBClient.execute(ksqlTableRequest).blockFirst(); + + Assertions.assertNotNull(response); + Assertions.assertNotNull(response.getCommandStatus()); + Assertions.assertEquals("SUCCESS", response.getCommandStatus().getStatus()); + + return response; + } + + protected Mono awaitQueryToBeRunning(String queryId) { + return Mono.create(sink -> { + ksqlDBClient.explain(new KsqlRequest("EXPLAIN " + queryId + ";")) + + .doOnNext(explainResponse -> LOGGER.info( + "Waiting for query {} to be in a running state. Current state : {}.", queryId, + explainResponse.getQueryDescription().getState())) + + .filter(explainResponse -> explainResponse.getQueryDescription().getState().equals("RUNNING")) + + .doOnNext(explainResponse -> sink.success(explainResponse)) + + .switchIfEmpty(Mono.error(() -> new RuntimeException(queryId + " is not running yet."))) + + .doOnError(throwable -> sink.error(throwable)) + + .subscribe(); + }).retryBackoff(5, Duration.ofSeconds(1)) + + .then(); + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/KsqlDBClientTestsApplication.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/KsqlDBClientTestsApplication.java new file mode 100644 index 0000000..d3eb9cf --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/KsqlDBClientTestsApplication.java @@ -0,0 +1,39 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests; + +import org.apache.kafka.clients.admin.AdminClient; +import org.springframework.beans.factory.annotation.Value; +import org.springframework.boot.autoconfigure.SpringBootApplication; +import org.springframework.boot.autoconfigure.kafka.KafkaProperties; +import org.springframework.context.annotation.Bean; + +import dev.daniellavoie.ksqldb.client.KsqlDBClient; + +@SpringBootApplication +public class KsqlDBClientTestsApplication { + @Bean + public AdminClient adminClient(KafkaProperties kafkaProperties) { + return AdminClient.create(kafkaProperties.buildAdminProperties()); + } + + @Bean + public KsqlDBClient ksqlDBClient(@Value("${ksqldb.url}") String ksqlDBUrl, + @Value("${ksqldb.websocket-url}") String ksqlDBWebSocketUrl) { + return KsqlDBClient.create(ksqlDBUrl, ksqlDBWebSocketUrl); + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/Transaction.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/Transaction.java new file mode 100644 index 0000000..852c848 --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/Transaction.java @@ -0,0 +1,92 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests; + +import java.math.BigDecimal; +import java.time.LocalDateTime; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonProperty; + +public class Transaction { + public enum Type { + DEPOSIT, EXCHANGE, WIDTHDRAW + } + + private final String guid; + private final String account; + private final Type type; + private final BigDecimal debitAmount; + private final String debitCurrency; + private final BigDecimal creditAmount; + private final String creditCurrency; + private final LocalDateTime timestamp; + + @JsonCreator + public Transaction(@JsonProperty("guid") String guid, @JsonProperty("account") String account, + @JsonProperty("type") Type type, @JsonProperty("debitAmount") BigDecimal debitAmount, + @JsonProperty("debitCurrency") String debitCurrency, @JsonProperty("creditAmount") BigDecimal creditAmount, + @JsonProperty("creditCurrency") String creditCurrency, @JsonProperty("timestamp") LocalDateTime timestamp) { + this.guid = guid; + this.account = account; + this.type = type; + this.debitAmount = debitAmount; + this.debitCurrency = debitCurrency; + this.creditAmount = creditAmount; + this.creditCurrency = creditCurrency; + this.timestamp = timestamp; + } + + public String getGuid() { + return guid; + } + + public String getAccount() { + return account; + } + + public Type getType() { + return type; + } + + public BigDecimal getDebitAmount() { + return debitAmount; + } + + public String getDebitCurrency() { + return debitCurrency; + } + + public BigDecimal getCreditAmount() { + return creditAmount; + } + + public String getCreditCurrency() { + return creditCurrency; + } + + public LocalDateTime getTimestamp() { + return timestamp; + } + + @Override + public String toString() { + return "Transaction [guid=" + guid + ", account=" + account + ", type=" + type + ", debitAmount=" + debitAmount + + ", debitCurrency=" + debitCurrency + ", creditAmount=" + creditAmount + ", creditCurrency=" + + creditCurrency + ", timestamp=" + timestamp + "]"; + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/info/InfoTests.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/info/InfoTests.java new file mode 100644 index 0000000..0534199 --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/info/InfoTests.java @@ -0,0 +1,59 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests.info; + +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.test.context.SpringBootTest; + +import dev.daniellavoie.ksqldb.client.KsqlDBClient; +import dev.daniellavoie.ksqldb.client.api.info.HealthcheckResponse; +import dev.daniellavoie.ksqldb.client.api.info.InfoResponse; + +@SpringBootTest +public class InfoTests { + @Autowired + private KsqlDBClient ksqlDBClient; + + @Test + public void assertInfo() { + InfoResponse infoResponse = ksqlDBClient.getInfo().block(); + + Assertions.assertNotNull(infoResponse); + Assertions.assertNotNull(infoResponse.getKsqlServerInfo()); + Assertions.assertNotNull(infoResponse.getKsqlServerInfo().getVersion()); + Assertions.assertNotNull(infoResponse.getKsqlServerInfo().getKsqlServiceId()); + Assertions.assertNotNull(infoResponse.getKsqlServerInfo().getKafkaClusterId()); + } + + @Test + public void assertHealthcheck() { + HealthcheckResponse healthcheckResponse = ksqlDBClient.getHealthcheck().block(); + + Assertions.assertNotNull(healthcheckResponse); + Assertions.assertTrue(healthcheckResponse.isHealthy()); + Assertions.assertNotNull(healthcheckResponse.getDetails()); + + Assertions.assertNotNull(healthcheckResponse.getDetails().getKafka()); + Assertions.assertTrue(healthcheckResponse.getDetails().getKafka().isHealthy()); + + Assertions.assertNotNull(healthcheckResponse.getDetails().getMetastore()); + Assertions.assertTrue(healthcheckResponse.getDetails().getMetastore().isHealthy()); + } + +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/kafka/KafkaUtil.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/kafka/KafkaUtil.java new file mode 100644 index 0000000..e184d9d --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/kafka/KafkaUtil.java @@ -0,0 +1,44 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests.kafka; + +import java.util.Arrays; +import java.util.concurrent.ExecutionException; + +import org.apache.kafka.clients.admin.AdminClient; +import org.apache.kafka.clients.admin.NewTopic; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +public abstract class KafkaUtil { + private static final Logger LOGGER = LoggerFactory.getLogger(KafkaUtil.class); + + public static void createTopicIfMissing(String topicName, AdminClient adminClient) { + try { + if (!adminClient.listTopics().names().get().stream() + .filter(existingTopic -> existingTopic.equals(topicName)).findAny().isPresent()) { + LOGGER.info("Creating topic {}.", topicName); + + NewTopic topic = new NewTopic(topicName, 1, (short)1); + + adminClient.createTopics(Arrays.asList(topic)).all().get(); + } + } catch (InterruptedException | ExecutionException e) { + throw new RuntimeException(e); + } + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/DescribeTest.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/DescribeTest.java new file mode 100644 index 0000000..8978472 --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/DescribeTest.java @@ -0,0 +1,60 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests.ksql; + +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.Test; +import org.springframework.boot.test.context.SpringBootTest; + +import dev.daniellavoie.ksqldb.client.api.ksql.DescribeResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import dev.daniellavoie.ksqldb.client.tests.EndpointTest; + +@SpringBootTest +public class DescribeTest extends EndpointTest { + + @Test + public void assertDescribeExtendedTable() { + DescribeResponse response = ksqlDBClient.describe(new KsqlRequest("DESCRIBE EXTENDED " + TABLE_NAME + ";")) + .blockFirst(); + + Assertions.assertNotNull(response); + } + + @Test + public void assertDescribeExtendedStream() { + DescribeResponse response = ksqlDBClient.describe(new KsqlRequest("DESCRIBE EXTENDED " + STREAM_NAME + ";")) + .blockFirst(); + + Assertions.assertNotNull(response); + } + + @Test + public void assertDescribeTable() { + DescribeResponse response = ksqlDBClient.describe(new KsqlRequest("DESCRIBE " + TABLE_NAME + ";")).blockFirst(); + + Assertions.assertNotNull(response); + } + + @Test + public void assertDescribeStream() { + DescribeResponse response = ksqlDBClient.describe(new KsqlRequest("DESCRIBE " + STREAM_NAME + ";")) + .blockFirst(); + + Assertions.assertNotNull(response); + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ExplainTest.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ExplainTest.java new file mode 100644 index 0000000..29a4c4a --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ExplainTest.java @@ -0,0 +1,46 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests.ksql; + +import java.util.List; + +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import dev.daniellavoie.ksqldb.client.api.ksql.ExplainResponse; +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import dev.daniellavoie.ksqldb.client.tests.EndpointTest; + +public class ExplainTest extends EndpointTest { + + private String queryId; + + @BeforeEach + public void setup() { + queryId = getQueries().blockFirst().getId(); + } + + @Test + public void assertExplainQuery() { + List responses = ksqlDBClient.explain(new KsqlRequest("EXPLAIN " + queryId + ";")) + .collectList().block(); + + Assertions.assertNotNull(responses); + Assertions.assertEquals(1, responses.size()); + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowPropertiesTest.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowPropertiesTest.java new file mode 100644 index 0000000..da2bde9 --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowPropertiesTest.java @@ -0,0 +1,33 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests.ksql; + +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.Test; + +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import dev.daniellavoie.ksqldb.client.api.ksql.PropertiesResponse; +import dev.daniellavoie.ksqldb.client.tests.EndpointTest; + +public class ShowPropertiesTest extends EndpointTest { + @Test + public void assertShowProperties() { + PropertiesResponse response = ksqlDBClient.properties(new KsqlRequest("SHOW PROPERTIES;")).blockFirst(); + + Assertions.assertNotNull(response); + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowStreamTest.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowStreamTest.java new file mode 100644 index 0000000..14abef3 --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowStreamTest.java @@ -0,0 +1,33 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests.ksql; + +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.Test; + +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import dev.daniellavoie.ksqldb.client.api.ksql.StreamsResponse; +import dev.daniellavoie.ksqldb.client.tests.EndpointTest; + +public class ShowStreamTest extends EndpointTest { + @Test + public void assertShowStreams() { + StreamsResponse response = ksqlDBClient.streams(new KsqlRequest("SHOW STREAMS;")).blockFirst(); + + Assertions.assertNotNull(response); + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowTableTest.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowTableTest.java new file mode 100644 index 0000000..749a448 --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/ksql/ShowTableTest.java @@ -0,0 +1,33 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests.ksql; + +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.Test; + +import dev.daniellavoie.ksqldb.client.api.ksql.KsqlRequest; +import dev.daniellavoie.ksqldb.client.api.ksql.TablesResponse; +import dev.daniellavoie.ksqldb.client.tests.EndpointTest; + +public class ShowTableTest extends EndpointTest { + @Test + public void assertShowTable() { + TablesResponse response = ksqlDBClient.tables(new KsqlRequest("SHOW TABLES;")).blockFirst(); + + Assertions.assertNotNull(response); + } +} diff --git a/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/query/QueryTest.java b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/query/QueryTest.java new file mode 100644 index 0000000..d67d44f --- /dev/null +++ b/integration-tests/src/test/java/dev/daniellavoie/ksqldb/client/tests/query/QueryTest.java @@ -0,0 +1,135 @@ +/* + * Copyright 2012-2019 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package dev.daniellavoie.ksqldb.client.tests.query; + +import java.math.BigDecimal; +import java.time.Duration; +import java.time.LocalDateTime; +import java.util.List; +import java.util.UUID; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Assertions; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; +import org.springframework.kafka.core.DefaultKafkaProducerFactory; +import org.springframework.kafka.core.KafkaTemplate; + +import dev.daniellavoie.ksqldb.client.api.query.QueryRequest; +import dev.daniellavoie.ksqldb.client.model.QueryRow; +import dev.daniellavoie.ksqldb.client.tests.EndpointTest; +import dev.daniellavoie.ksqldb.client.tests.Transaction; +import dev.daniellavoie.ksqldb.client.tests.Transaction.Type; +import reactor.core.Disposable; +import reactor.core.publisher.Flux; +import reactor.core.publisher.Mono; +import reactor.core.scheduler.Schedulers; + +public class QueryTest extends EndpointTest { + private static final Logger LOGGER = LoggerFactory.getLogger(QueryTest.class); + + private KafkaTemplate transactionTemplate; + private Disposable disposable; + + @BeforeEach + public void setup() { + transactionTemplate = new KafkaTemplate( + new DefaultKafkaProducerFactory<>(kafkaProperties.buildProducerProperties())); + } + + @AfterEach + public void tearDown() { + if (disposable != null) { + disposable.dispose(); + } + } + + @Test + public void assertPullQuery() throws InterruptedException { + awaitQueryToBeRunning(lastQueryId).block(); + + List results = ksqlDBClient + .pullQuery(new QueryRequest("SELECT * FROM " + TABLE_NAME + " WHERE ROWKEY='1';")) + + .switchIfEmpty(Mono.error(() -> new RuntimeException("No result found yet"))) + + .retryBackoff(5, Duration.ofSeconds(1)) + + .collectList() + + .block(); + + Assertions.assertEquals(1, results.size()); + } + + @Test + public void assertPushQuery() throws InterruptedException { + awaitQueryToBeRunning(lastQueryId).block(); + + Flux flux = Flux.create(sink -> { + disposable = ksqlDBClient + .pushQuery(new QueryRequest("SELECT * FROM " + TABLE_NAME + " WHERE ROWKEY='1' EMIT CHANGES;")) + + .doOnNext(queryRow -> LOGGER.info("Received a query event.")) + + .doOnNext(sink::next) + + .doOnError(sink::error) + + .doOnComplete(sink::complete) + + .subscribeOn(Schedulers.elastic()) + + .publishOn(Schedulers.elastic()) + + .subscribe(); + + try { + Thread.sleep(5000); + } catch (InterruptedException e) { + LOGGER.error("Sleep interrupted", e); + } + + Flux.range(0, 50) + + .doOnNext(index -> LOGGER.info("Generating a transaction.")) + + .map(index -> new Transaction(UUID.randomUUID().toString(), "1", Type.DEPOSIT, null, "USD", + BigDecimal.ONE, "USD", LocalDateTime.now())) + + .flatMap(transaction -> Mono.fromFuture( + transactionTemplate.send(TOPIC_NAME, transaction.getAccount(), transaction).completable())) + + .blockLast(); + + transactionTemplate.flush(); + + LOGGER.info("Sent the events to Kafka."); + }); + + QueryRow result = flux + + .blockFirst(Duration.ofSeconds(30)); + + Assertions.assertEquals("1", result.getRow().getColumns().get(1)); + Assertions.assertEquals("1", result.getRow().getColumns().get(2)); + Assertions.assertEquals(50, result.getRow().getColumns().get(3)); + } + +} diff --git a/integration-tests/src/test/resources/application.properties b/integration-tests/src/test/resources/application.properties new file mode 100644 index 0000000..19e83c6 --- /dev/null +++ b/integration-tests/src/test/resources/application.properties @@ -0,0 +1,10 @@ +spring.application.name=ksql-java-client-it + +spring.kafka.producer.key-serializer=org.apache.kafka.common.serialization.StringSerializer +spring.kafka.producer.value-serializer=org.springframework.kafka.support.serializer.JsonSerializer +spring.kafka.producer.properties.spring.json.add.type.headers=false + +ksqldb.url=http://localhost:8088 +ksqldb.websocket-url=ws://localhost:8088 + +logging.level.dev.daniellavoie.ksqldb=TRACE diff --git a/mvnw b/mvnw new file mode 100755 index 0000000..41c0f0c --- /dev/null +++ b/mvnw @@ -0,0 +1,310 @@ +#!/bin/sh +# ---------------------------------------------------------------------------- +# Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +# ---------------------------------------------------------------------------- + +# ---------------------------------------------------------------------------- +# Maven Start Up Batch script +# +# Required ENV vars: +# ------------------ +# JAVA_HOME - location of a JDK home dir +# +# Optional ENV vars +# ----------------- +# M2_HOME - location of maven2's installed home dir +# MAVEN_OPTS - parameters passed to the Java VM when running Maven +# e.g. to debug Maven itself, use +# set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +# MAVEN_SKIP_RC - flag to disable loading of mavenrc files +# ---------------------------------------------------------------------------- + +if [ -z "$MAVEN_SKIP_RC" ] ; then + + if [ -f /etc/mavenrc ] ; then + . /etc/mavenrc + fi + + if [ -f "$HOME/.mavenrc" ] ; then + . "$HOME/.mavenrc" + fi + +fi + +# OS specific support. $var _must_ be set to either true or false. +cygwin=false; +darwin=false; +mingw=false +case "`uname`" in + CYGWIN*) cygwin=true ;; + MINGW*) mingw=true;; + Darwin*) darwin=true + # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home + # See https://developer.apple.com/library/mac/qa/qa1170/_index.html + if [ -z "$JAVA_HOME" ]; then + if [ -x "/usr/libexec/java_home" ]; then + export JAVA_HOME="`/usr/libexec/java_home`" + else + export JAVA_HOME="/Library/Java/Home" + fi + fi + ;; +esac + +if [ -z "$JAVA_HOME" ] ; then + if [ -r /etc/gentoo-release ] ; then + JAVA_HOME=`java-config --jre-home` + fi +fi + +if [ -z "$M2_HOME" ] ; then + ## resolve links - $0 may be a link to maven's home + PRG="$0" + + # need this for relative symlinks + while [ -h "$PRG" ] ; do + ls=`ls -ld "$PRG"` + link=`expr "$ls" : '.*-> \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG="`dirname "$PRG"`/$link" + fi + done + + saveddir=`pwd` + + M2_HOME=`dirname "$PRG"`/.. + + # make it fully qualified + M2_HOME=`cd "$M2_HOME" && pwd` + + cd "$saveddir" + # echo Using m2 at $M2_HOME +fi + +# For Cygwin, ensure paths are in UNIX format before anything is touched +if $cygwin ; then + [ -n "$M2_HOME" ] && + M2_HOME=`cygpath --unix "$M2_HOME"` + [ -n "$JAVA_HOME" ] && + JAVA_HOME=`cygpath --unix "$JAVA_HOME"` + [ -n "$CLASSPATH" ] && + CLASSPATH=`cygpath --path --unix "$CLASSPATH"` +fi + +# For Mingw, ensure paths are in UNIX format before anything is touched +if $mingw ; then + [ -n "$M2_HOME" ] && + M2_HOME="`(cd "$M2_HOME"; pwd)`" + [ -n "$JAVA_HOME" ] && + JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`" +fi + +if [ -z "$JAVA_HOME" ]; then + javaExecutable="`which javac`" + if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then + # readlink(1) is not available as standard on Solaris 10. + readLink=`which readlink` + if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then + if $darwin ; then + javaHome="`dirname \"$javaExecutable\"`" + javaExecutable="`cd \"$javaHome\" && pwd -P`/javac" + else + javaExecutable="`readlink -f \"$javaExecutable\"`" + fi + javaHome="`dirname \"$javaExecutable\"`" + javaHome=`expr "$javaHome" : '\(.*\)/bin'` + JAVA_HOME="$javaHome" + export JAVA_HOME + fi + fi +fi + +if [ -z "$JAVACMD" ] ; then + if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + else + JAVACMD="`which java`" + fi +fi + +if [ ! -x "$JAVACMD" ] ; then + echo "Error: JAVA_HOME is not defined correctly." >&2 + echo " We cannot execute $JAVACMD" >&2 + exit 1 +fi + +if [ -z "$JAVA_HOME" ] ; then + echo "Warning: JAVA_HOME environment variable is not set." +fi + +CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher + +# traverses directory structure from process work directory to filesystem root +# first directory with .mvn subdirectory is considered project base directory +find_maven_basedir() { + + if [ -z "$1" ] + then + echo "Path not specified to find_maven_basedir" + return 1 + fi + + basedir="$1" + wdir="$1" + while [ "$wdir" != '/' ] ; do + if [ -d "$wdir"/.mvn ] ; then + basedir=$wdir + break + fi + # workaround for JBEAP-8937 (on Solaris 10/Sparc) + if [ -d "${wdir}" ]; then + wdir=`cd "$wdir/.."; pwd` + fi + # end of workaround + done + echo "${basedir}" +} + +# concatenates all lines of a file +concat_lines() { + if [ -f "$1" ]; then + echo "$(tr -s '\n' ' ' < "$1")" + fi +} + +BASE_DIR=`find_maven_basedir "$(pwd)"` +if [ -z "$BASE_DIR" ]; then + exit 1; +fi + +########################################################################################## +# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +# This allows using the maven wrapper in projects that prohibit checking in binary data. +########################################################################################## +if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found .mvn/wrapper/maven-wrapper.jar" + fi +else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..." + fi + if [ -n "$MVNW_REPOURL" ]; then + jarUrl="$MVNW_REPOURL/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" + else + jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" + fi + while IFS="=" read key value; do + case "$key" in (wrapperUrl) jarUrl="$value"; break ;; + esac + done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties" + if [ "$MVNW_VERBOSE" = true ]; then + echo "Downloading from: $jarUrl" + fi + wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" + if $cygwin; then + wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"` + fi + + if command -v wget > /dev/null; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found wget ... using wget" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + wget "$jarUrl" -O "$wrapperJarPath" + else + wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath" + fi + elif command -v curl > /dev/null; then + if [ "$MVNW_VERBOSE" = true ]; then + echo "Found curl ... using curl" + fi + if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then + curl -o "$wrapperJarPath" "$jarUrl" -f + else + curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f + fi + + else + if [ "$MVNW_VERBOSE" = true ]; then + echo "Falling back to using Java to download" + fi + javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java" + # For Cygwin, switch paths to Windows format before running javac + if $cygwin; then + javaClass=`cygpath --path --windows "$javaClass"` + fi + if [ -e "$javaClass" ]; then + if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Compiling MavenWrapperDownloader.java ..." + fi + # Compiling the Java class + ("$JAVA_HOME/bin/javac" "$javaClass") + fi + if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then + # Running the downloader + if [ "$MVNW_VERBOSE" = true ]; then + echo " - Running MavenWrapperDownloader.java ..." + fi + ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR") + fi + fi + fi +fi +########################################################################################## +# End of extension +########################################################################################## + +export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"} +if [ "$MVNW_VERBOSE" = true ]; then + echo $MAVEN_PROJECTBASEDIR +fi +MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" + +# For Cygwin, switch paths to Windows format before running java +if $cygwin; then + [ -n "$M2_HOME" ] && + M2_HOME=`cygpath --path --windows "$M2_HOME"` + [ -n "$JAVA_HOME" ] && + JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` + [ -n "$CLASSPATH" ] && + CLASSPATH=`cygpath --path --windows "$CLASSPATH"` + [ -n "$MAVEN_PROJECTBASEDIR" ] && + MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"` +fi + +# Provide a "standardized" way to retrieve the CLI args that will +# work with both Windows and non-Windows executions. +MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $@" +export MAVEN_CMD_LINE_ARGS + +WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +exec "$JAVACMD" \ + $MAVEN_OPTS \ + -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ + "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ + ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" diff --git a/mvnw.cmd b/mvnw.cmd new file mode 100644 index 0000000..8611571 --- /dev/null +++ b/mvnw.cmd @@ -0,0 +1,182 @@ +@REM ---------------------------------------------------------------------------- +@REM Licensed to the Apache Software Foundation (ASF) under one +@REM or more contributor license agreements. See the NOTICE file +@REM distributed with this work for additional information +@REM regarding copyright ownership. The ASF licenses this file +@REM to you under the Apache License, Version 2.0 (the +@REM "License"); you may not use this file except in compliance +@REM with the License. You may obtain a copy of the License at +@REM +@REM http://www.apache.org/licenses/LICENSE-2.0 +@REM +@REM Unless required by applicable law or agreed to in writing, +@REM software distributed under the License is distributed on an +@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +@REM KIND, either express or implied. See the License for the +@REM specific language governing permissions and limitations +@REM under the License. +@REM ---------------------------------------------------------------------------- + +@REM ---------------------------------------------------------------------------- +@REM Maven Start Up Batch script +@REM +@REM Required ENV vars: +@REM JAVA_HOME - location of a JDK home dir +@REM +@REM Optional ENV vars +@REM M2_HOME - location of maven2's installed home dir +@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands +@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending +@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven +@REM e.g. to debug Maven itself, use +@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 +@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files +@REM ---------------------------------------------------------------------------- + +@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' +@echo off +@REM set title of command window +title %0 +@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on' +@if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% + +@REM set %HOME% to equivalent of $HOME +if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") + +@REM Execute a user defined script before this one +if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre +@REM check for pre script, once with legacy .bat ending and once with .cmd ending +if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat" +if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd" +:skipRcPre + +@setlocal + +set ERROR_CODE=0 + +@REM To isolate internal variables from possible post scripts, we use another setlocal +@setlocal + +@REM ==== START VALIDATION ==== +if not "%JAVA_HOME%" == "" goto OkJHome + +echo. +echo Error: JAVA_HOME not found in your environment. >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +:OkJHome +if exist "%JAVA_HOME%\bin\java.exe" goto init + +echo. +echo Error: JAVA_HOME is set to an invalid directory. >&2 +echo JAVA_HOME = "%JAVA_HOME%" >&2 +echo Please set the JAVA_HOME variable in your environment to match the >&2 +echo location of your Java installation. >&2 +echo. +goto error + +@REM ==== END VALIDATION ==== + +:init + +@REM Find the project base dir, i.e. the directory that contains the folder ".mvn". +@REM Fallback to current working directory if not found. + +set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% +IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir + +set EXEC_DIR=%CD% +set WDIR=%EXEC_DIR% +:findBaseDir +IF EXIST "%WDIR%"\.mvn goto baseDirFound +cd .. +IF "%WDIR%"=="%CD%" goto baseDirNotFound +set WDIR=%CD% +goto findBaseDir + +:baseDirFound +set MAVEN_PROJECTBASEDIR=%WDIR% +cd "%EXEC_DIR%" +goto endDetectBaseDir + +:baseDirNotFound +set MAVEN_PROJECTBASEDIR=%EXEC_DIR% +cd "%EXEC_DIR%" + +:endDetectBaseDir + +IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig + +@setlocal EnableExtensions EnableDelayedExpansion +for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a +@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% + +:endReadAdditionalConfig + +SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" +set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" +set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain + +set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" + +FOR /F "tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( + IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B +) + +@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central +@REM This allows using the maven wrapper in projects that prohibit checking in binary data. +if exist %WRAPPER_JAR% ( + if "%MVNW_VERBOSE%" == "true" ( + echo Found %WRAPPER_JAR% + ) +) else ( + if not "%MVNW_REPOURL%" == "" ( + SET DOWNLOAD_URL="%MVNW_REPOURL%/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" + ) + if "%MVNW_VERBOSE%" == "true" ( + echo Couldn't find %WRAPPER_JAR%, downloading it ... + echo Downloading from: %DOWNLOAD_URL% + ) + + powershell -Command "&{"^ + "$webclient = new-object System.Net.WebClient;"^ + "if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^ + "$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^ + "}"^ + "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^ + "}" + if "%MVNW_VERBOSE%" == "true" ( + echo Finished downloading %WRAPPER_JAR% + ) +) +@REM End of extension + +@REM Provide a "standardized" way to retrieve the CLI args that will +@REM work with both Windows and non-Windows executions. +set MAVEN_CMD_LINE_ARGS=%* + +%MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* +if ERRORLEVEL 1 goto error +goto end + +:error +set ERROR_CODE=1 + +:end +@endlocal & set ERROR_CODE=%ERROR_CODE% + +if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost +@REM check for post script, once with legacy .bat ending and once with .cmd ending +if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat" +if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd" +:skipRcPost + +@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' +if "%MAVEN_BATCH_PAUSE%" == "on" pause + +if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE% + +exit /B %ERROR_CODE% diff --git a/pom.xml b/pom.xml new file mode 100644 index 0000000..55f9c86 --- /dev/null +++ b/pom.xml @@ -0,0 +1,84 @@ + + + 4.0.0 + dev.daniellavoie.ksqldb + ksqldb-java-client-parent + 0.2.0-SNAPSHOT + pom + Non-Blocking Reactive Java Client for ksqlDB - Parent + Non-Blocking Reactive Java Client for ksqlDB - Parent + https://github.com/daniellavoie/ksqldb-java-client + + + The Apache Software License, Version 2.0 + http://www.apache.org/licenses/LICENSE-2.0.txt + repo + + + + + daniellavoie + Daniel Lavoie + dlavoie@live.ca + + + + scm:git:git://github.com/daniellavoie/ksqldb-java-client + scm:git:git://github.com/daniellavoie/ksqldb-java-client + https://github.com/daniellavoie/ksqldb-java-client + + + GitHub Issues + https://github.com/daniellavoie/ksqldb-java-client/issues + + + + ossrh + https://oss.sonatype.org/content/repositories/snapshots + + + ossrh + https://oss.sonatype.org/service/local/staging/deploy/maven2/ + + + + + client + + + + + + + + org.apache.maven.plugins + maven-source-plugin + 3.2.0 + + + attach-sources + verify + + jar-no-fork + + + + + + org.apache.maven.plugins + maven-javadoc-plugin + 3.1.1 + + + + + + + + dev.daniellavoie.ksqldb + ksqldb-java-client + ${project.version} + + + + diff --git a/samples/simple-client/.classpath b/samples/simple-client/.classpath new file mode 100644 index 0000000..90f81ed --- /dev/null +++ b/samples/simple-client/.classpath @@ -0,0 +1,38 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/samples/simple-client/pom.xml b/samples/simple-client/pom.xml new file mode 100644 index 0000000..506c007 --- /dev/null +++ b/samples/simple-client/pom.xml @@ -0,0 +1,21 @@ + + 4.0.0 + dev.daniellavoie.ksqldb.client.sample + sample-client + 0.1.0-SNAPSHOT + + + + oss-sonatype-snapshot + https://oss.sonatype.org/content/repositories/snapshots + + + + + + dev.daniellavoie.ksqldb + ksqldb-java-client + 0.1.0-SNAPSHOT + + + \ No newline at end of file