1. cmdb资产审计
2.stark组件使用
快速完成网站的一个组件,使用方式与django的admin系统类似 ,仅仅将model注册 ,就可以生成对model增删改查的页面 ,当然这里还包括了模糊搜索 ,排序 ,批量操作等等
1)拷贝并注册stark应用到项目中(settings)
2)在根url.py中注册stark组件的url
from django.conf.urls import url, include
from django.contrib import admin
from stark.service.stark import site
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^api/', include('api.urls')),
url(r'^stark/', site.urls),
]
3)以业务线为例, 使用stark组件的部分功能
list_display = [] # 看了下源码 ,列表中主要放函数与字段 ,如果是函数的话就把从数据库拿到的queryset数据拿来循环 ,如果是字段就返回html展示
search_list = [] # 允许用哪些字段作为搜索条件
order_by = [] # 以某个字段排序 ,升序 ,可以加负号完成反向排序
action_list = [] # 下拉操作列表选项 ,组件中有multi_delete方法完成批量删除 ,也可以自己定义方法(如批量更新 ,可以在request.POST中选择pk ,再通过model操作进行更新)
def 定义函数 ,或者重写已有函数
site注册model ,并添加配置类
##stark.py注册model文件
1.定义配置类
class BusinessUnitConfig(StarkConfig):
list_display = [StarkConfig.display_checkbox, 'id', 'name']
search_list = ['id', 'name']
order_by = ['-id']
def multi_apply(self, request):
print(request.POST)
return redirect('http://www.baidu.com')
multi_apply.text = '批量更新'
action_list = [StarkConfig.multi_delete,multi_apply]
2.应用配置类 ,注册到stark
site.register(models.BusinessUnit, BusinessUnitConfig)
4)以Server服务器为例 ,使用stark组件的部分功能
list_display = [] # 展示choice字段 ,需要定义一个函数指定标题头部
###server的model中device_status_id这个字段
device_status_choices = (
(1, '上架'), (2, '在线'), (3, '离线'), (4, '下架'),
)
device_status_id = models.IntegerField(choices=device_status_choices, default=1)
方法1:自定义函数 ,返回html代码段 ,对于choice状态不同的id展示不同的颜色 ,在list_display中直接写上函数名即可
方法2:使用get_choice_text( '字段' ,标题头)
class ServerConfig(StarkConfig):
# row是orm对象 ,可以展示choices的内容
def show_status(self, header=None, row=None):
if header:
return '状态'
color = {
1: 'red',
2: 'green',
3: 'blue',
4: 'yellow'
}
# return row.get_device_status_id_display()
return mark_safe('<span style="color:{}">{}</span>'.format(color.get(row.device_status_id),
row.get_device_status_id_display()))
list_display = ['id', 'hostname', show_status, 'os_platform', 'os_version','business_unit', get_choice_text('device_status_id', '状态2')]
search_list = [] #如果以表中某一个外键为搜索条件, 例如服务器的外键业务线的名称 ?上下滑直接指定即可
search_list = ['hostname', 'os_version', 'business_unit__name']
list_filter = [] # 快速检索 ,以按钮的形式将条件展示 ,如果选中拿出对应的pk在filter中组合筛选 (search_list与list_filter两个会联合查询)
list_filter组合搜索展示choice字段的按钮 ,该字段必须有choice ,text_func与value_func必须使用匿名函数 ,匿名函数的参数就是choices元祖的每一个值
list_filter = [
Option('business_unit', is_multi=True),
# lambda中的x是(1:'上线') text_func是文本显示结果 value_func是url上对应的值 要对应
Option('device_status_id', is_multi=True, is_choice=True, text_func=lambda x: x[1], value_func=lambda x: x[0])
]
5)bootstrap的datetimepicker日历时间选择器(为一些填写时间的字段增加体验) (https://www.jianshu.com/p/48b2343ded54更多功能)
首先需要自己写modelform并继承stark的modelform ,为生成时间字段增加date-picker类名称
然后在配置类中引用自定义的modelform
其次加载js与css文件即可
class ServerModelForm(StarkModelForm):
class Meta:
model = models.Server
fields = "__all__"
widgets = {
'latest_date': DatePickerInput(attrs={'class': 'date-picker'})
}
class ServerConfig(StarkConfig):
model_form_class = ServerModelForm
...
6)扩展功能 ,stark注册一个model ,生成增删改查资格url与对应的视图函数 ,但是扩展的功能想自定义的功能如何去完成 ?
扩展功能1.增加显示服务器详情(硬盘内存网卡信息) 2.增加服务器审计信息展示
在配置类定义url ,通过extra_url()函数实现
在配置类定义视图函数
在配置类定义每行显示的标签以及跳转url
class ServerConfig(StarkConfig):
model_form_class = ServerModelForm
def server_detail(self, request, pk):
server_disks = models.Disk.objects.filter(server_id=pk).order_by('slot')
server_memorys = models.Memory.objects.filter(server_id=pk)
server_nics = models.NIC.objects.filter(server_id=pk)
return render(request, 'server/server_detail.html',
{'server_disks': server_disks,
'server_memorys': server_memorys,
'server_nics': server_nics, })
def server_record(self, request, pk):
server_record = models.AssetRecord.objects.filter(server_id=pk)
return render(request, 'server/server_record.html',
{'server_record': server_record,
})
def extra_url(self):
from django.conf.urls import url
urlpatterns = [
url(r'^server_detail/(\d+)/', self.server_detail),
url(r'^server_record/(\d+)/', self.server_record),
]
return urlpatterns
def show_detail(self, header=None, row=None):
if header:
return '主机详情'
return mark_safe('<a href="/stark/api/server/server_detail/{}">查看</a>'.format(row.pk))
def show_record(self, header=None, row=None):
if header:
return '审计'
return mark_safe('<a href="/stark/api/server/server_record/{}">查看</a>'.format(row.pk))
# row是orm对象 ,可以展示choices的内容
def show_status(self, header=None, row=None):
if header:
return '状态'
color = {
1: 'red',
2: 'green',
3: 'blue',
4: 'yellow'
}
return mark_safe('<span style="color:{}">{}</span>'.format(color.get(row.device_status_id),
row.get_device_status_id_display()))
list_display = ['id',
'hostname',
show_status,
'os_platform',
'os_version',
'business_unit',
get_choice_text('device_status_id', '状态2'), show_detail, show_record]
search_list = ['hostname',
'os_version',
'business_unit__name']
list_filter = [
Option('business_unit', is_multi=True),
# lambda中的x是(1:'上线') text_func是文本显示结果 value_func是url上对应的值 要对应
Option('device_status_id', is_multi=True, is_choice=True, text_func=lambda x: x[1], value_func=lambda x: x[0])
]
View Code
3.stark功能总结
1)注册model ,生成4个url ,以及4个视图函数
/stark/应用名/model名/(增删改查)
2)展示页面的功能
展示字段 (普通字段 ,choices字段 ,外键字段)
模糊搜索
自定义方法
批量操作
组合搜索(快速筛选)
分页
扩展功能(url)
保留搜索条件(分页 ,搜索条件在新增编辑时候都保留)
新增编辑可以自定义modelform与datepicker插件
4.stark组件的部分功能源码解读
6. 实现的机制
1). 注册APP 'stark.apps.StarkConfig',
django的ready函数 ——》 app目录下找stark.py并执行
stark.py导入site对象
site.register(model的类,配置类)
实例化一个 Mapping的对象 (model的类,配置对象(model的类, site的对象) )
class ModelConfigMapping(object):
def __init__(self, model, config, prev):
self.model = model
self.config = config
self.prev = prev
site._registry是个列表里面全是mapping对象[ Mapping的对象 ]
2). stark的路由(多重使用django的url函数进行分发!)
url(r'stark/', site.urls)
r'stark/',( [] ,app_name,namespace )
url(r'api/server/',( [], ))
api/server/list/
api/server/add/
api/server/(?P<pk>\d+)/change/
api/server/(?P<pk>\d+)/del/
根据一个model至少生成4个url地址(包括extra扩展的url)