com.github.hippo-band:hippo-common

common of hippo rpc framework

License

License

GroupId

GroupId

com.github.hippo-band
ArtifactId

ArtifactId

hippo-common
Last Version

Last Version

1.1.1-RELEASE
Release Date

Release Date

Type

Type

jar
Description

Description

com.github.hippo-band:hippo-common
common of hippo rpc framework
Project URL

Project URL

https://github.com/hippo-band/hippo.git
Source Code Management

Source Code Management

https://github.com/hippo-band/hippo

Download hippo-common

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.hippo-band/hippo-common/ -->
<dependency>
    <groupId>com.github.hippo-band</groupId>
    <artifactId>hippo-common</artifactId>
    <version>1.1.1-RELEASE</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.hippo-band/hippo-common/
implementation 'com.github.hippo-band:hippo-common:1.1.1-RELEASE'
// https://jarcasting.com/artifacts/com.github.hippo-band/hippo-common/
implementation ("com.github.hippo-band:hippo-common:1.1.1-RELEASE")
'com.github.hippo-band:hippo-common:jar:1.1.1-RELEASE'
<dependency org="com.github.hippo-band" name="hippo-common" rev="1.1.1-RELEASE">
  <artifact name="hippo-common" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.hippo-band', module='hippo-common', version='1.1.1-RELEASE')
)
libraryDependencies += "com.github.hippo-band" % "hippo-common" % "1.1.1-RELEASE"
[com.github.hippo-band/hippo-common "1.1.1-RELEASE"]

Dependencies

compile (11)

Group / Artifact Type Version
io.netty : netty-all jar 4.1.4.Final
org.springframework : spring-context jar 4.3.1.RELEASE
com.dyuproject.protostuff : protostuff-core jar 1.0.10
com.dyuproject.protostuff : protostuff-runtime jar 1.0.10
org.objenesis : objenesis jar 2.4
com.alibaba : fastjson jar 1.2.36
org.slf4j : slf4j-api jar 1.7.5
ch.qos.logback : logback-classic jar 1.1.2
ch.qos.logback : logback-core jar 1.1.2
org.apache.commons : commons-lang3 jar 3.1
com.github.hippo-band : hippo-annotation jar 1.1.1-RELEASE

Project Modules

There are no modules declared in this project.

概述:

Hippo: 一个基于java的微服务框架,配置简单、使用方便。

Hippo1.1.1版本存在OOM BUG,已解决,修复版本为1.1.1-RELEASE。具体参考:http://www.holyshared.com/detail.html?issueId=5a3c7ac40cf28bf3bddfeb41

快速开始

可以下载 demo 进行测试,由于默认服务注册使用的是eureka,在测试Demo的时候需要先起一个eureka服务.具体查看 https://github.com/hippo-band/hippo-demo

前提条件

  • JDK: version 8 or higher
  • Maven: version 3 or higher

Maven dependency

maven分的比较细,具体如下:

提供接口的项目需要依赖以下pom

<!-- https://mvnrepository.com/artifact/com.github.hippo-band/hippo-annotation -->

<dependency>

    <groupId>com.github.hippo-band</groupId>

    <artifactId>hippo-annotation</artifactId>

    <version>1.1.1-RELEASE</version>

</dependency>

接口的具体实现类的项目(也就是服务端)需要依赖以下pom

ps:hippo-server-with-eureka是集成了去eureka注册的相关代码

<!-- https://mvnrepository.com/artifact/com.github.hippo-band/hippo-server-with-eureka -->

<dependency>

    <groupId>com.github.hippo-band</groupId>

    <artifactId>hippo-server-with-eureka</artifactId>

    <version>1.1.1-RELEASE</version>

</dependency>

客户端需要依赖以下pom

ps:hippo-cleint-with-eureka同样集成了去eureka获取注册信息的相关代码

<!-- https://mvnrepository.com/artifact/com.github.hippo-band/hippo-client-with-eureka -->
<dependency>
    <groupId>com.github.hippo-band</groupId>
    <artifactId>hippo-client-with-eureka</artifactId>
    <version>1.1.1-RELEASE</version>
</dependency>

也有不依赖eureka的pom依赖 就是去掉server/client artifactId后面的-with-eureka(那就需要自己实现服务注册的相关代码[实现ServiceGovern

接口])

定义接口

package com.github.hippo.demo.service;

@HippoService(serviceName = "hippo.demo.service")
public interface TestService{
    public String ping(String username);
}

@HippoService(serviceName = "hippo.demo.service") 就是定义服务注册名,通常很多都写在配置文件里的,hippo采用在接口上定义注解实现,优点是在client调用的时候代码就很简洁。 ps:多个接口在同一个项目里必须使用同一个服务注册名

接口实现类

package com.github.hippo.demo.service.impl;

@HippoServiceImpl()
public class TestServiceImpl implements TestService{
   @Override
  public String ping(String username) {
    return username;
  }
}

@HippoServiceImpl就是打个注解可以注入到spring.

服务配置

在任一*.properties里配上eureka地址即可
eureka.serviceUrl=http://127.0.0.1/eureka/

至于服务ip和端口hippo会自动获取,当然也是可以人工在*.properties指定。 然后启动项目即可,如果使用的是hippo-demo那就是直接运行ServerContainer类.

客户端配置

在任一*.properties里配上eureka地址即可
eureka.serviceUrl=http://127.0.0.1/eureka/

和service provider一样的配置

Junit Test

package junitTest

@ContextConfiguration(locations = "classpath:/application-context.xml")
@RunWith(SpringJUnit4ClassRunner.class)
public class TestServiceTest {
  
  @HippoClient
  private TestService testService;
  
  @Test
  public void ping() throws Exception {
    testService.ping("sl");
  }
}

Just so so?

支持3种调用方式 sync async-with-callback oneway 集成hystrix可以实现降级熔断等 支持json方式的通信方式,主要集成在apigate实现透传调用服务,再也不用写一个server在配套写一个webapp项目提供http服务了。

如下

@Test
  public void ping1() throws Throwable {
    System.out.println(hippoProxy.apiRequest("hippo.demo.service", "TestService/ping1",
        "{\"username\":\"598fdc0b0cf29eb2a0928a6d\",\"test\":[1,2,3]}"));
  }

服务内部实现了调用链,通过调用链可以串起所有的请求走向。 提供了集成elk的logback代码。 。。。。。。未完待续

com.github.hippo-band

Versions

Version
1.1.1-RELEASE
1.1.1
1.1.0
1.0.1
1.0.0
0.0.2
0.0.1