# djmicroservice
django restfull框架下的微服务应用包。
一. 安装
* 依赖包
+ django >=2.0
+ djangorestframework >=3.8
+ djangorestframework-jwt >=1.6
+ djkeeper >=0.2
+ South >=1.0
+ coreapi >=2.3.3
+ simple-rest-client >=0.5.2
+ stomp.py >=4.1.20
* 安装
```
#pip install -r requirements.txt
#python setup.py install
```
* 配置
+ django 配置
- INSTALLED_APPS配置项增加
```
INSTALLED_APPS = [
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'rest_framework',
'djmicroservice',
]
```
- 增加 REST_FRAMEWORK配置项
```
REST_FRAMEWORK = {
'DEFAULT_PERMISSION_CLASSES': (
),
'DEFAULT_AUTHENTICATION_CLASSES': (
'rest_framework_jwt.authentication.JSONWebTokenAuthentication',
),
}
```
- 增加 REST_FRAMEWORK配置项
```
REST_FRAMEWORK = {
'DEFAULT_PERMISSION_CLASSES': (
),
'DEFAULT_AUTHENTICATION_CLASSES': (
'rest_framework_jwt.authentication.JSONWebTokenAuthentication',
),
}
```
- 增加 JWT_AUTH配置项
```
JWT_AUTH = {
'JWT_ENCODE_HANDLER':'rest_framework_jwt.utils.jwt_encode_handler',
'JWT_DECODE_HANDLER':'rest_framework_jwt.utils.jwt_decode_handler',
'JWT_PAYLOAD_HANDLER':'user.jwt.handlers.onlyuser_jwt_payload_handler',
'JWT_PAYLOAD_GET_USER_ID_HANDLER':'rest_framework_jwt.utils.jwt_get_user_id_from_payload_handler',
'JWT_RESPONSE_PAYLOAD_HANDLER':'user.jwt.handlers.onlyuser_jwt_response_payload_handler',
'JWT_SECRET_KEY': SECRET_KEY,
'JWT_GET_USER_SECRET_KEY': None,
'JWT_PUBLIC_KEY': None,
'JWT_PRIVATE_KEY': None,
'JWT_ALGORITHM': 'HS256',
'JWT_VERIFY': True,
'JWT_VERIFY_EXPIRATION': True,
'JWT_LEEWAY': 0,
'JWT_EXPIRATION_DELTA': datetime.timedelta(seconds=36000),
'JWT_AUDIENCE': None,
'JWT_ISSUER': None,
'JWT_ALLOW_REFRESH': True,
'JWT_REFRESH_EXPIRATION_DELTA': datetime.timedelta(days=7),
'JWT_AUTH_HEADER_PREFIX': 'JWT',
'JWT_AUTH_COOKIE': None,
}
```
- 增加 DJMICROSERVICE配置项
```
DJMICROSERVICE = {
#微服务名字
'NAME': DEFAULT_NAME ,
#微服务URL
'URL': 'http://127.0.0.1:8000/',
#是否是主节点
'MASTER': True,
#微服务资源
'RESOURCES': {
},
#服务发现配置
'DISCOVER': {
#是否注册
'REGISTER': False,
#心跳
'HEARTBEAT': 15,
#发现者引擎
'ENGINE': 'djmicroservice.discovers.backends.StaticDiscover',
#引擎配置
'OPTIONS': {
'SERVICES':[
]
},
},
#客户端配置
'CLIENT':{
#认证管理微服务名
'AUTH': None,
'OBTAIN': None,
'REFRESH': None,
'VERIFY': None,
'USER': None,
'PASSWORD': None,
'JWT_HEADER_PFX': 'JWT',
'TIMEOUT': 2,
'AUTO_LOGIN': False,
},
#消息队列端配置
'MQ':{
#消息队列引擎
'ENGINE': 'djmicroservice.mq.backends.ActiveMQ',
#引擎配置
'OPTIONS': {
#消息服务器地址,可以多个
'SERVERS': [('127.0.0.1',61613)],
#消息服务器登录名
'USER': 'admin',
#消息服务器密码
'PASSWORD': 'admin',
},
'HANDLERS': {
},
},
'SERVICE_MANAGER':{
#服务管理地址
'BIND':('127.0.0.1',56560),
'AUTH_KEY':None,
#要启动的服务
'SERVICES':[
('onlyuser.mq.service.MQService', 1),
]
}
}
```
二. RESTful API规范
