ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了

引言 在使用asp.net core 进行api开发完成后,书写api说明文档对于程序员来说想必是件很痛苦的事情吧,但文档又必须写,而且文档的格式如果没有具体要求的话,最终完成的文档则完全取决于开发者的心情。或者详细点,或者简单点。那么有没有一种快速有效的方法来构建api说明文档呢?答案是肯定的, Swagger就是最受欢迎的REST APIs文档生成工具之一! 为什么使用Swagger作为REST APIs文档生成工具 Swagger 可以生成一个具有互动性的API控制台,开发者可以用来快速学习和尝试API。 Swagger 可以生成客户端SDK代码用于各种不同的平台上的实现。 Swagger 文件可以在许多不同的平台上从代码注释中自动生成。 Swagger 有一个强大的社区,里面有许多强悍的贡献者。 asp.net core中如何使用Swagger生成api说明文档呢 Swashbuckle.AspNetCore 是一个开源项目,用于生成 ASP.NET Core Web API 的 Swagger 文档。 NSwag 是另一个用于将 Swagger UI 或 ReDoc 集成到 ASP.NET Core Web API 中的开源项目。 它提供了为 API 生成 C# 和 TypeScript 客户端代码的方法。 下面以Swashbuckle.AspNetCore为例为大家进行展示 Swashbuckle由哪些组成部分呢? Swashbuckle.AspNetCore.Swagger:将 SwaggerDocument 对象公开为 JSON 终结点的 Swagger 对象模型和中间件。 Swashbuckle.AspNetCore.SwaggerGen:从路由、控制器和模型直接生成 SwaggerDocument 对象的 Swagger 生成器。 它通常与 Swagger 终结点中间件结合,以自动公开 Swagger JSON。 Swashbuckle.AspNetCore.SwaggerUI:Swagger UI 工具的嵌入式版本。 它解释 Swagger JSON 以构建描述 Web API 功能的可自定义的丰富体验。 它包括针对公共方法的内置测试工具。 如何使用vs2017安装Swashbuckle呢? 从“程序包管理器控制台”窗口进行安装 转到“视图” > “其他窗口” > “程序包管理器控制台” 导航到包含 TodoApi.csproj 文件的目录 请执行以下命令 ·Install-Package […]

龙生   15 Jul 2019
View Details

HSqlDB(java内置数据库)

1 HSqlDB简介 HSQLDB是一款Java内置的数据库,非常适合在用于快速的测试和演示的Java程序中。(无需独立安装数据库)  HSQLDB有三种模式: 1. Server 就像Mysql那样 2. In-Process 又叫做 Standalone 模式,数据放在本地文件,伴随JVM一起启动,是HSQLDB的主要应用场景 3. Memory-only, 仅仅在内存中,一旦重启,数据就消失。 2 客户端 2.1 运行HSQLDB_Client类中的main方法 其主方法调用了DatabaseManagerSwing的主方法 这回导致启动一个Swing做的客户端 2.2 创建数据库,账号和密码 填写连接参数 1. Setting Name:输入test 2. Type: 选择HSQL Database Engine Standalone 3. Driver: 使用默认的org.hsqldb.jdbcDriver 4. URL: 输入 Jdbc:hsqldb:file: D:/SoftWareInstall/HSqlDB/test 5. User: root 6: Password:root 第3步: 这是Standalone方式,对于同一个数据库,只能启动一次,不支持多进程连接同一个数据库,所以后续在写JAVA代码连接的时候,必须把这个客户端关闭掉才行。 第4步: Jdbc:hsqldb:file: D:/SoftWareInstall/HSqlDB/test会导致在D:/SoftWareInstall/HSqlDB目录下创建一个test数据库 第5,6步:会导致创建账号密码,以后再连接D:/SoftWareInstall/HSqlDB下的test数据库,就必须用这个账号密码了。 2.3 创建表 CREATE TABLE category (   id int NOT NULL GENERATED BY DEFAULT AS IDENTITY,   name varchar(255) DEFAULT NULL,   PRIMARY KEY (id) ) ; insert into category values (null,'水果'); insert into category values (null,'衣服'); insert into […]

龙生   15 Jul 2019
View Details

js闭包用法

闭包 既保证了 内部函数的私有性 又可以向外公开 通过一个已有对象 向它注入属性

  from:https://www.cnblogs.com/friends-wf/p/3781859.html

龙生   12 Jul 2019
View Details

javascript – 闭包之一些常见的写法

  from:https://www.cnblogs.com/cisum/p/9577246.html

龙生   12 Jul 2019
View Details

全面理解Javascript闭包和闭包的几种写法及用途

一、什么是闭包和闭包的几种写法和用法 1、什么是闭包 闭包,官方对闭包的解释是:一个拥有许多变量和绑定了这些变量的环境的表达式(通常是一个函数),因而这些变量也是该表达式的一部分。闭包的特点: 1. 作为一个函数变量的一个引用,当函数返回时,其处于激活状态。 2. 一个闭包就是当一个函数返回时,一个没有释放资源的栈区。 简单的说,Javascript允许使用内部函数—即函数定义和函数表达式位于另一个函数的函数体内。而且,这些内部函数可以访问它们所在的外部函数中声明的所有局部变量、参数和声明的其他内部函数。当其中一个这样的内部函数在包含它们的外部函数之外被调用时,就会形成闭包。   2、闭包的几种写法和用法 首先要明白,在JS中一切都是对象,函数是对象的一种。下面先来看一下闭包的5种写法,简单理解一下什么是闭包。后面会具体解释。

这种写法没什么特别的,只是给函数添加一些属性。

这种写法是声明一个变量,将一个函数当作值赋给变量。

  这种方法最好理解,就是new 一个对象,然后给对象添加属性和方法。

  这种方法使用较多,也最为方便。var obj = {}就是声明一个空的对象。

说实话,这种写法我是没用过,大家可以参考一下。 总的来说,上面几种方法,第2中和第4中较为常见,大家可以根据习惯选择。 上面代码中出现了JS中常用的Prototype,那么Prototype有什么用呢?下面我们来看一下:

  我们首先声明一个变量,将一个函数赋给他,因为在Javascript中每个函数都有一个Portotype属性,而对象没有。添加两个方法,分别直接添加和添加打破Prototype上面,来看下调用情况。分析结果如下: 1、不使用prototype属性定义的对象方法,是静态方法,只能直接用类名进行调用!另外,此静态方法中无法使用this变量来调用对象其他的属性! 2、使用prototype属性定义的对象方法,是非静态方法,只有在实例化后才能使用!其方法内部可以this来引用对象自身中的其他属性!   下面我们再来看一段代码:

  大家先看看,会显示什么呢? 答案是两个都显示Undefined,为什么呢?这是由于在Javascript中每个function都会形成一个作用域,而这些变量声明在函数中,所以就处于这个函数的作用域中,外部是无法访问的。要想访问变量,就必须new一个实例出来。

  再来看看这种写法,其实这是Javascript的一个"语法糖",这种写法相当于:

  变量html是一个对象,不是函数,所以没有Prototype属性,其方法也都是公有方法,html不能被实例化。否则会出现如下错误: 但是他可以作为值赋给其它变量,如var o = html; 我们可以这样使用它:

说到这里,完了吗?细心的人会问,怎么访问Success方法中的Say方法呢?是html.Success.Say()吗? 当然不是,上面刚说过由于作用域的限制,是访问不到的。所以要用下面的方法访问:

关于Javascript作用域的问题,不是一两句能说清楚的,有兴趣的大家可以网上找些资料看看。    二、Javascript闭包的用途 事实上,通过使用闭包,我们可以做很多事情。比如模拟面向对象的代码风格;更优雅,更简洁的表达出代码;在某些方面提升代码的执行效率。 1、匿名自执行函数 我们知道所有的变量,如果不加上var关键字,则默认的会添加到全局对象的属性上去,这样的临时变量加入全局对象有很多坏处, 比如:别的函数可能误用这些变量;造成全局对象过于庞大,影响访问速度(因为变量的取值是需要从原型链上遍历的)。 除了每次使用变量都是用var关键字外,我们在实际情况下经常遇到这样一种情况,即有的函数只需要执行一次,其内部变量无需维护, 比如UI的初始化,那么我们可以使用闭包:

我们创建了一个匿名的函数,并立即执行它,由于外部无法引用它内部的变量,因此在函数执行完后会立刻释放资源,关键是不污染全局对象。   2、结果缓存 我们开发中会碰到很多情况,设想我们有一个处理过程很耗时的函数对象,每次调用都会花费很长时间, 那么我们就需要将计算出来的值存储起来,当调用这个函数的时候,首先在缓存中查找,如果找不到,则进行计算,然后更新缓存并返回值,如果找到了,直接返回查找到的值即可。闭包正是可以做到这一点,因为它不会释放外部的引用,从而函数内部的值可以得以保留。

这样我们在第二次调用的时候,就会从缓存中读取到该对象。   3、封装

  4、实现类和继承

我们定义了Person,它就像一个类,我们new一个Person对象,访问它的方法。 下面我们定义了Jack,继承Person,并添加自己的方法。   from:https://www.cnblogs.com/jiayc/p/9365837.html

龙生   12 Jul 2019
View Details

一个公式告诉你CDN适合带宽计费还是流量计费

CDN的计费方式有两种,一种是按带宽计费,一种是按流量计费,有些小伙伴在使用的时候对于该选择带宽还是流量计费总是模棱两可,所以,本篇就来说下带宽计费和流量计费的差异和转换方式。 差异 首先通过单位来区分流量和带宽,比如带宽的单位通常是Mbps(兆比特/秒),而流量的单位是MB(兆字节),简单来看,带宽指的是一种传输速度,而流量是一种传输数量。 这里要强调一下上面的两个单位: 带宽单位:Mbps=Mbit/s(bit是比特) 流量单位:MB=MByte(byte是字节) 了解单位以后,我们来做个计算,假如我开通了10Mbit/s带宽,问在100%使用的情况下,一个月(30天)能跑出多少流量? 怎么算呢?按下面的换算方式 (1 MB = 1024 KB) (1 GB = 1024 MB) (1 TB = 1024 GB) 有人可能会这样算: 10Mbps = 10MB/秒,1天能产生的流量=24小时 * 3600秒 * 10MB=843.75GB,一个月的总流量就是24.72T。 问这里算出来的数字对吗?答案是不对,因为10Mbps ≠ 10MB/秒,为什么呢? 再来看下换算: (1 Byte = 8 Bit) 从这个单位换算可以看出,1 Byte = 8 Bits,也就是说,1Bits=0.125Byte, 所以,10Mbps=10Mbit/s=1.25MB,而不等于10MB/秒。 这个时候我们再来算下10Mbit/s带宽,在100%使用的情况下,一个月(30天)能跑出的流量: 10Mbps = 1.25MB/秒,1天能产生的流量=24小时 * 3600秒 * 1.25MB=105.5GB,一个月的总流量就是3.09T。 结论 带宽和流量之间模棱两可的主要原因就在单位上,很多人会误以为10兆(Mbps)的带宽就意味着每秒产生10M流量,但实际上,Mbps的意思是兆比特每秒,而1 Byte(字节) = 8 Bit(比特),反过来 1Bit(比特)=0.125 Byte(字节),由此我们得出: 10Mbps = 1.25MB/秒 在没弄清这个之前,我也是觉得按10Mbps = 10MB/秒来测算带宽对应流量的差距不会很大,但弄清后,你会发现这个差距还是比较大的。 10Mbps = 10MB/秒,1天能产生的流量=24小时 * 3600秒 * 10MB=843.75GB,一个月的总流量就是24.72T。 10Mbps = 1.25MB/秒,1天能产生的流量=24小时 * 3600秒 * 1.25MB=105.5GB,一个月的总流量就是3.09T。 一个是24.72T,一个是3.09T,相差21.63T。 应用 说完它们之间的差异,再来回答一下题目的问题:CDN适合带宽计费还是流量计费呢? 举个例子,假设我有个网站,就一个页面,这个页面上有100M的图片和10G的视频,即这个页面的数据为100M+10G=10.1G,每访问一次这个页面,将产生10.1G的流量。 然后再假设这个网站每天固定有100人访问,那每天产生的流量就是1T,每个月(30天)的流量就是30T,问如果用CDN做加速,是选流量计费还是带宽计费呢? 先来看下融合CDN厂商猫云的报价。 […]

龙生   10 Jul 2019
View Details

Chimee – 简单易用的H5视频播放器解决方案

Chimee是由奇舞团开源的一套H5视频播放器解决方案,由奇舞团视频云前端团队结合在业务和视频编解码方向的沉淀积累倾心打造。Chimee支持MP4、M3U8、FLV等多种媒体格式,同时它也帮我们解决了大部分的兼容性、差异化问题,包括全屏、自动播放、内联播放、直播解码等常见媒体播放需求。 通过便捷的可热插拔的插件开发,能满足业务方快速迭代、灰度发布等要求;让开发者能够更轻松快捷地完成不同业务场景下UI、广告等各种功能需求的开发。   在线演示      免费下载   from:https://www.cnblogs.com/lhb25/p/chimee-h5-video-player.html

龙生   09 Jul 2019
View Details

HLS

HLS (HTTP Live Streaming)是Apple的动态码率自适应技术。主要用于PC和Apple终端的音视频服务。包括一个m3u(8)的索引文件,TS媒体分片文件和key加密串文件。   常用的流媒体协议主要有 HTTP 渐进下载和基于 RTSP/RTP 的实时流媒体协议,这二种基本是完全不同的东西,目前比较方便又好用的是用 HTTP 渐进下载方法。在这个中 apple 公司的 HTTP Live Streaming 是这个方面的代表。它最初是苹果公司针对iPhone、iPod、iTouch和iPad等移动设备而开发的流.现在见到在桌面也有很多应用了,HTML5 是直接支持这个。 但是HLS协议的小切片方式会生成大量的文件,存储或处理这些文件会造成大量资源浪费。如果要实现数天的时移,索引量将会是个巨额数字,并明显影响请求速度。因此,HLS协议对存储I/O要求相当苛刻。对此,也有公司提出了非常好的解决方案。 新型点播服务器系统,独创了内存缓存数据实时切片技术,颠覆了这种传统实现方法,从根本上解决了大量切片的碎片问题,使得单台服务器的切片与打包能力不再是瓶颈。其基本原理如下: 不将TS切片文件存到磁盘,而是存在内存当中,这种技术使得服务器的磁盘上面不再会有“数以吨计”的文件碎片,极大减少了磁盘的I/O次数,延长了服务器磁盘的使用寿命,极大提高了服务器运行的稳定性。同时,由于使用这种技术,使得终端请求数据时直接从服务器的内存中获取,极大提高了对终端数据请求的反应速度,优化了视频观看体验。 from:https://baike.baidu.com/item/HLS/8328931

龙生   09 Jul 2019
View Details

有关当前主流视频网站采用的解决方案

这几天由于工作中要搭建视频点播平台,分析了一下当前主流视频网站采用的技术。主要分析了腾讯、优酷、土豆、爱奇艺这几个平台,他们采用的技术却惊人的相似。全都是采用m3u8这样的解决方案,视频分成小段,方便在网络中的快速传输。也能防止非技术人员的下载~~,如果真正意义上的防下载,几乎是不可能的,尤其是基于H5的技术。 虎牙直播用的也是m3u8的解决方案,有一些延迟,不过可以接受。斗鱼用的渐进时流的推送,但直播结束时应该也是可以保存起来的。 不过话又说回来,点播和直播的意义并不防下载,这个防下载还应该以知识产权相关的法律去保障,同时培养公民尊重知识产权。 扯远了,说说m3u8解决方案用的具体细节吧: 1.首先m3u8来自Apple公司的HLS( HTTP Live Streaming 是Apple的动态码率自适应技术)。 2.动态解码,或者说分段可以用开源软件FFmpeg,功能相当强大。网址:http://ffmpeg.org/ 3.播放器就用简单易用的Chimee,免费哦。网址:http://chimee.org/    当然也可以用收费的flowplayer,都有H5的解决方案。网址:https://flowplayer.com/

龙生   09 Jul 2019
View Details

ffmpeg基础使用

参考 ffmpeg常用命令 ffmpeg参数中文详细解释 [总结]FFMPEG视音频编解码零基础学习方法 一、安装 打开https://ffmpeg.zeranoe.com/builds/,该网站中的FFMPEG分为3个版本:Static,Shared,Dev。 前两个版本可以直接在命令行中使用,他们的区别在于:Static里面只有3个应用程序:ffmpeg.exe,ffplay.exe,ffprobe.exe,每个exe的体积都很大,相关的Dll已经被编译到exe里面去了。Shared里面除了3个应用程序:ffmpeg.exe,ffplay.exe,ffprobe.exe之外,还有一些Dll,比如说avcodec-54.dll之类的。Shared里面的exe体积很小,他们在运行的时候,到相应的Dll中调用功能。Dev版本是用于开发的,里面包含了库文件xxx.lib以及头文件xxx.h,这个版本不包含exe文件。 这里下载了static版本,是个zip压缩文件,解压到指定目录,去配置环境变量,比如e:\ffmpeg20180919\bin,这样bin下面的ffmpeg.exe就可以在命令行中使用了,可以用ffmpeg -version测试一下: image.png 放一个mp4视频,然后把声音提取到output.acc,用命令测试一下:ffmpeg -i mov_bbb.mp4 -acodec copy -vn output.aac 二、常用命令 主要参数:

视频参数:

音频参数:

1. 视频格式转换 (其实格式转换说法不太准确,但大家都这么叫,准确的说,应该是视频容器转换) 比如一个avi文件,想转为mp4,或者一个mp4想转为ts。 ffmpeg -i input.avi output.mp4 ffmpeg -i input.mp4 output.ts 插个号外:某天我在知乎上看到一段视频,想转给微信好友看,怎么操作呢。这里参考如何全自动下载知乎上的视频到本地(注意不要滥用),先打开要观看的视频页面,再F12清空,然后开始播放视频,就能看到类似https://vdn.vzuu.com/SD/49c84c7c-c61a-11e8-8bad-0242ac112a0a.mp4?auth_key=1539832492-0-0-c61c22f39c&expiration=1539832492&disable_local_cache=1这样的字符串,然后用ffmpeg -i "https://vdn.vzuu.com/SD/49c8…" output.mp4即可下载。弄到电脑上,用电脑QQ发送到手机QQ上,在手机QQ上点击选择保存到手机上。然后在微信里选照片就能看到这个视频了(注意视频文件不要超过20M,另外最开始用的不是电脑QQ,而是百度网盘,发现不行……)。 2. 提取音频 比如我有一个“晓松奇谈”,可是我不想看到他的脸,我只想听声音, 地铁上可以听,咋办? ffmpeg -i 晓松奇谈.mp4 -acodec copy -vn output.aac 上面的命令,默认mp4的audio codec是aac,如果不是会出错,咱可以暴力一点,不管什么音频,都转为最常见的aac。 ffmpeg -i 晓松奇谈.mp4 -acodec aac -vn output.aac (-vn 不处理视频 ) 3. 提取视频 我目测有些IT员工,特别是做嵌入式的,比如机顶盒,想debug一下,没有音频的情况下,播放一个视频几天几夜会不会crash,这时候你需要一个纯视频文件,可以这么干。 ffmpeg -i input.mp4 -vcodec copy -an output.mp4 -an 不处理音频 4. 视频剪切 经常要测试视频,但是只需要测几秒钟,可是视频却有几个G,咋办?切啊! 下面的命令,就可以从时间为00:00:15开始,截取5秒钟的视频。 ffmpeg -ss 00:00:15 -t 00:00:05 -i input.mp4 -vcodec copy […]

龙生   09 Jul 2019
View Details
1 154 155 156 414