码迷,mamicode.com
首页 > Windows程序 > 详细

harbor rest api 转graphql api

时间:2018-08-17 22:20:45      阅读:302      评论:0      收藏:0      [点我收藏+]

标签:lin   line   open   apollo   des   ==   swa   test   order   

原理

实际上就是使用graphql 中的binding,首先基于swagger api 进行schema 生成,后边就是
使用binding 进行graphql 请求api 转换为rest api 请求,目前测试过两个开源的方案:
prisma 的graphql-openapi-binding 以及swagger-graphql 类库

步骤

  • swagger 模型生成graphql schema

使用cli 工具 swagger-to-graphql

npm install -g swagger-to-graphql 
harbor swagger 文件
https://raw.githubusercontent.com/goharbor/harbor/master/docs/swagger.yaml
可以使用swagger editor 转换为json格式,同时我们暂时需要先删除带有文件操作的api
swagger-to-graphql --swagger=/path/to/swaggerjson > ./swagger.graphql
  • swagger-to-graphql 使用

    比较简单,基于swagger 2 graphql npm 包

package.json:
{
"name": "swagger-graphql",
"version": "1.0.0",
"main": "index.js",
"license": "MIT",
"dependencies": {
"babel-polyfill": "^6.26.0",
"express": "^4.16.3",
"express-graphql": "^0.6.12",
"graphql": "^0.13.2",
"swagger-to-graphql": "^1.4.0"
},
"scripts": {
"start": "node app"
}
}

app.js:
require(‘babel-polyfill‘);
const express = require(‘express‘);
const app = express();
const graphqlHTTP = require(‘express-graphql‘);
const graphQLSchema = require(‘swagger-to-graphql‘);

const proxyUrl = ‘https://harborserver/api‘;
const pathToSwaggerSchema = `${__dirname}/api/swagger.json`;
const customHeaders = {
Authorization: ‘Basic YWRkOmJhc2ljQXV0aA==‘
};

graphQLSchema(pathToSwaggerSchema, proxyUrl, customHeaders).then(schema => {
app.use(‘/graphql‘, graphqlHTTP(() => {
return {
schema,
graphiql: true
};
}));

app.listen(3009, ‘0.0.0.0‘, () => {
console.info(‘http://localhost:3009/graphql‘);
});
}).catch(e => {
console.log(e);
});
  • graphql-binding-openapi

    类似

app.js

const { OpenApi } = require(‘graphql-binding-openapi‘)
const { GraphQLServer } = require(‘graphql-yoga‘)
const {importSchema} = require("graphql-import")

const typeDefs = importSchema("./schema.graphql")
const resolvers = {
Query: {
get_search: async (parent, args, context, info) => {
return context.harbor.query.get_search({ status: "available" }, context, info)
}
}
}

const server = new GraphQLServer({
resolvers,
typeDefs,
context: async req => ({
...req,
harbor: await OpenApi.init(‘./harbor.json‘, ‘https://harborapiserver‘)
})
});

server.start(() => console.log(‘Server running on http://localhost:4000‘))

package.json:

{
"name": "open-api",
"version": "1.0.0",
"main": "index.js",
"license": "MIT",
"dependencies": {
"graphql-binding-openapi": "^1.0.5",
"graphql-import": "^0.6.0",
"graphql-yoga": "^1.16.0"
},
"scripts": {
"start":"node app"
}
}

几个问题

  • file schema type
因为字段类型file 暂时转换不支持,但是可以手工调整
转换的时候会提示file 类型未定义,解决方法,暂时删除了关于文件的部分
实际上可以集成prisma 后者apollo 自带file type 的resolver
  • 访问api 登录的问题
当前测试的开放的api,大部分api是需要进行认证的,可以还有待测试

效果

技术分享图片

测试

  • query
query {
  get_repositories_top(count:3){
    name
    description
    pull_count
  } 
}
  • 结果
{
  "data": {
    "get_repositories_top": [
      {
        "name": "library/kubedns-amd64",
        "description": null,
        "pull_count": null
      },
      {
        "name": "coredns/coredns",
        "description": null,
        "pull_count": null
      },
      {
        "name": "marketing/mk-platform-order-test",
        "description": null,
        "pull_count": null
      }
    ]
  }
}
  • 界面
    技术分享图片

参考资料

https://github.com/graphql-binding/graphql-binding-openapi
https://github.com/yarax/swagger-to-graphql#readme
https://github.com/rongfengliang/swagger-to-graphql-docker/tree/harborgraphql

harbor rest api 转graphql api

标签:lin   line   open   apollo   des   ==   swa   test   order   

原文地址:https://www.cnblogs.com/rongfengliang/p/9495331.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!