结合使用AngularJS和Django
好吧，我承认自己很懒，时间又不够用。
翻译的几个文章都是虎头蛇尾，但我保证这次肯定不太监。
关键的单词不翻译，实在觉得翻译成汉语很别扭，括号里是参考翻译。
有问题和建议尽管提出来，我会改进完善。
Tutorial: Using AngularJS with Django
原文：http://glynjackson.org/weblog/entry/django-angular.html 点我进原文
Posted on: 31 Jan 2014, 4:58 p.m. Categories: Django Frameworks Python
我原本打算写一个如何结合Angular和Django的快速入门，但最后证明这只是一篇喝了红牛后的冲动产物。抱歉草草结束。（这是作者原话）
看了几个结合使用Angular和Django的文章，我发现自己在重新发明轮子。尽管我给出的例子很粗糙，但是它们已经足够展示我在项目中如何操作。
Models （模型）
一个标准Django模型
/jobs/models.py
class Job(models.Model):
name = models.CharField(max_length=50)
description = models.TextField(null=True, blank=True)
目前为止还没什么特别之处。你所做的只是创建了一个简单的模型来存基本的工作信息。
The REST API （Tastypie）
AngularJS被发明来终结webservices，所以你只需要提供你刚创建的Job模型就足够了。
Django在创建 RESTful APIs 上很有一套。 TastyPie是为Django创建的极好的web服务框架。 TastyPie及其强大，易于配置和使用。 抛开个人喜好，使用Django REST framework也能做同样的事情，甚至能直接用Django构造你自己的API响应。 使用哪个的选择权在你。 这篇文章我会使用 TastyPie。
若你不熟悉TastyPie ，看这个文档（点我） 。我不会详说安装等细枝末节的东西。我假定你已经安装配置好了TastyPie ，并却已经准备好和我继续下去了。
首先，你需要为你的jobs创建一个resource。 TastyPie遵循“Resources”这样的理念， 它把resource作为end user和objects（这里指的是Job模型）的中介。
为Job模型创建一个适当的resource：
class JobResource(ModelResource):
"""
API Facet
"""
class Meta:
queryset = Jobs.objects.all()
resource_name = 'job'
allowed_methods = ['post', 'get', 'patch', 'delete']
authentication = Authentication()
authorization = Authorization()
always_return_data = True
我记得TastyPies官方文档建议在你的应用中用api.py来命名此文件。这也是我的做法，尽管它不是强制的。你可以随意命名，但是按照约定命名文件可以保证一致性。
JobResource 的一些设置已经超出了本文章的范围。但我乐于解释JobResource是继承自ModelResource的。 结合Tastypie与Django ORM两者使用。扩展它意味着你已经能够能深入API的基本实现了。
TastyPie 也能处理非ORM数据。通过直接扩展Resource，你也能够得到TastyPie提供的所有好处。 No SQL数据库描述如下（点我）。
现在你已经创建了模型和与之交互的方式。接下来，你需要一个把resource连接到实际URL的步骤，如此，AngularJS才能发挥它的作用。 简单的举例说明如何在Django URLConf里建立这样的连接。：
from tastypie.api import Api
from .apps.your_app.api import JobResource v1_api = Api(api_name='v1')
v1_api.register(JobResource()) urlpatterns = patterns('', (r'^api/', include(v1_api.urls)),
)
在JobResource指定resource_name属性是最后一步。现在，你已经创立了一个有效绑定Resource到Job模型上的API。 检查它在server上是否工作良好，用你的浏览器访问 http://127.0.0.1:8000/api/job/?format=json 。
Forms
在你深入AngularJS前，我们来创建一个Job form。 Job form会让你在你的应用中轻松编写Jobs。我知道你会问，为什么要这么做。
好吧，Django其中一个哲学就是，不做重复劳动（Don't repeat yourself (DRY）)。 所以创建为AngularJS写HTML，然后在Django也这么做就显得极不合理，因为Django会帮你做这件事。你可能已经有了很多需要转换的forms。为什么要重复这个过程？ 点击 django-angular. 这是一个很酷的包，你会喜欢它的。
Quote: "Django-Angular is a collection of utilities, which aim to ease the integration of Django with AngularJS by providing reusable components."
现在我架设你已经安装好了 Django-Angular 。把这些放进一个如'crispy forms'的包里，你会得到一个一站式的解决方案 -- 这是我为什么喜欢Django和它的社区。
from .app.your_app.models import Job
from .apps.djangular.forms import NgFormValidationMixin, NgModelFormMixin, AddPlaceholderFormMixin class JobForm(NgModelFormMixin, forms.ModelForm):
"""
Job Form with a little crispy forms added!
"""
def __init__(self, *args, **kwargs):
super(JobForm, self).__init__(*args, **kwargs)
setup_bootstrap_helpers(self) class Meta:
model = Job
fields = ('name', 'description',) def setup_bootstrap_helpers(object):
object.helper = FormHelper()
object.helper.form_class = 'form-horizontal'
object.helper.label_class = 'col-lg-3'
object.helper.field_class = 'col-lg-8'
On to AngularJS
为了简便，你需要创建如下三个模板。
templates
jobs/index.html
jobs/new.html
base.html
这说明你有一个叫job的app并且已经安装了。你的base模板会像下面一样：
/jobs/base.html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<link href="//cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.0.2/css/bootstrap.min.css" rel="stylesheet"> <script src="//ajax.googleapis.com/ajax/libs/angularjs/1.2.7/angular.js"></script>
<script src="/angular-ui-router.min.js"></script>
<script type="text/javascript" src="http://cdn.jsdelivr.net/restangular/latest/restangular.js"></script> </head>
<body>
{% block content %}{% endblock content %}
{% block extra_javascript %}{% endblock extra_javascript %}
</body>
</html>
Django-Angular已经提供了很多很好的模板标签，这些标签包含了必要的javascript。我建议使用分布式目录网络（CDN）来加载必要的文件。如此做，你会得到明显的地理上的和宽带资源上的好处。
你需要创建一个page模板。index.html会作为主页，它会接收请求。
/jobs/index.html
{% extends "base.html" %}
{% load i18n %}
{% block content %}
<div class="container content" ng-app="JobApp">
<div ui-view >Loading...</div>
</div>
{% endblock content %}
{% block extra_javascript %}
<script src="{{ STATIC_URL }}/javascript/app.js"></script>
{% endblock extra_javascript %}
/javascript/app.js
var app = angular.module('JobApp', [
'ui.router',
'restangular'
])
app.config(function ($stateProvider, $urlRouterProvider, RestangularProvider) {
// For any unmatched url, send to /route1
$urlRouterProvider.otherwise("/");
$stateProvider
.state('index', {
url: "/",
templateUrl: "/static/html/partials/_job_list.html",
controller: "JobList"
})
.state('new', {
url: "/new",
templateUrl: "/jobs/job-form",
controller: "JobFormCtrl"
})
})
app.controller("JobFormCtrl", ['$scope', 'Restangular', 'CbgenRestangular', '$q',
function ($scope, Restangular, CbgenRestangular, $q) {
}])// end controller
模板和js非常简单，它们继承自base模板。有几个必须要明白的属性你可能没见过。
第一个是 ng-app='JobApp'。 没有这个标签，AngularJS不会起作用。这个指令告诉AngularJS哪一个元素是应用的根元素。你所向根元素写入的东西会成为被AngularJS管理的一部分。
接下来，看你在index.html里引入的的脚本文件。 app.js 脚本定义了angular模块。 当应用被booted（启动）时， 一个angular模块就是函数的集合。
var app = angular.module('JobApp', [
上一行创建了名为JobApp的模块。 在index.html里你已经通过声明属性为ng-app='JobApp'来实例化它了。你所做的就是告诉AngularJS你想让app.js包含所需的所有。
实际上，你可以把ng-app设置成任何DOM中的元素。例如，如果你只想模板其中一个部分被AngularJS控制，你可以这样做：
<h2>I am not inside an AngularJS app</h2>
<div ng-app="embeddedApp">
<h3>Inside an AngularJS app</h3>
</div>
在app.js里的app.config展示了你URL路由（routing）。AngularJS通过默认的变量 $route 来提供URL路由，但是不太适当，并且有限制。
其中你已经包括进来的模板是 AngularUI Router ‘ui.router’。 AngularUI Router是另一个为AngularJS扩展的围绕状态扩展的路由框架。
你提供了仅仅一个叫做new的state，其实可以为你的应用包含许多不同的state。 甚至当没有state返回时，你可以添加一个默认的行为。
$urlRouterProvider.otherwise("/");
$stateProvider
.state('index', {
url: "/",
templateUrl: "static/html/somepage.html",
controller: "SomeController"
})
如果你还不熟悉这些，看完此文我建议你读 AngularUI Router。
最后你要了解的元素是ui-view。 这也是AngularUI Router 模型的一部分。 ui-view 指令告诉 $state 哪里放置你的模板，例如， templateUrl: "/job/new/"。
最后你要创建的模板是 /jobs/new.html。 这里包括了你刚才用 Django-Angular 创建的basic form。
{% load crispy_forms_tags %}
{% crispy JobForm %}
<button type="button" class="btn btn-default" ng-click="submitJob()">Create</button>
现在把view和URL连接到form。
/jobs/views.py
from .forms import JobForm class JobFormView(TemplateView):
template_name = "jobs/new.html" def get_context_data(self, **kwargs):
context = super(JobFormView, self).get_context_data(**kwargs)
context.update(JobForm=JobForm())
return context
/jobs/urls.py
from django.conf.urls import url
from django.conf.urls import patterns from .views import JobFormView urlpatterns = patterns('', url(r'^job-form/$',
login_required(JobFormView.as_view()),
name='job_form'), )
用你的浏览器访问 http://127.0.0.1:8000/job/#new。 你会看到刚才的劳动成果。
Restangular is an AngularJS service that simplifies common GET, DELETE, and UPDATE requests with a minimum of client code. It's a perfect fit for any WebApp that consumes data from a RESTful API. restangular
app.controller("JobFormCtrl", ['$scope', 'Restangular', 'CbgenRestangular', '$q',
function ($scope, Restangular, CbgenRestangular, $q) {
$scope.submitJob = function () {
var post_update_data = create_resource($scope, CbgenRestangular);
$q.when(post_update_data.then(
function (object) {
// success!
},
function (object){
// error!
console.log(object.data)
}
))
}
}])// end controller
app.factory('CbgenRestangular', function (Restangular) {
return Restangular.withConfig(function (RestangularConfigurer) {
RestangularConfigurer.setBaseUrl('/api/v1');
});
})
populate_scope_values = function ($scope) {
return {name: $scope.name, description: $scope.description };
},
create_resource = function ($scope, CbgenRestangular) {
var post_data = populate_scope_values($scope)
return CbgenRestangular.all('job').post(post_data)
},
Where to go from here
Too much to cover in just one blog post. Best practices should be your next step and head over to egghead, best tutorials on the web in my opinion.
结合使用AngularJS和Django的更多相关文章
- Tutorial: 结合使用AngularJS和Django
好吧,我承认自己很懒,时间又不够用. 翻译的几个文章都是虎头蛇尾,但我保证这次肯定不太监. 关键的单词不翻译,实在觉得翻译成汉语很别扭,括号里是参考翻译. 有问题和建议尽管提出来,我会改进完善. Tu ...
- 解决AngularJS和Django模板标签冲突问题
原地址 Django和AngularJS在模板中使用同样的符号来引用变量,例如 {{variable_name}}. 有两种解决办法,各有利弊.一个修改AngularJS模板语法,另一个使用Djang ...
- angularjs 与django标签语法冲突的解决办法
在需要使用angularjs标签的地方套上verbatim标签,如: {% verbatim %} ... {% endverbatim %}
- Django 优秀资源大全
版权: https://github.com/haiiiiiyun/awesome-django-cn 转自:https://www.jianshu.com/p/38c4dd6d8e28 Awesom ...
- 用Django Rest Framework和AngularJS开始你的项目
Reference: http://blog.csdn.net/seele52/article/details/14105445 译序:虽然本文号称是"hello world式的教程&quo ...
- 浅谈Django的Q查询以及AngularJS的Datatables分页插件
使用Q查询,首先要导入Q模块: from django.db.models import Q 可以组合使用&,|操作符用于多个Q的对象,产生一个新的Q对象,Q对象也可以用~操作符放在前面表示否 ...
- Getting Started with Django Rest Framework and AngularJS
转载自:http://blog.kevinastone.com/getting-started-with-django-rest-framework-and-angularjs.html A ReST ...
- Angularjs $http服务的两个request安全问题
今天为了hybrid app和后端restful服务的安全认证问题,又翻了一下$http的文档,$http服务文档页面两个安全问题是json和XSRF,JSON那个比较好理解,就不补充什么了,说说XS ...
- 【转】Laravel+Angularjs+D3打造可视化数据,RESTful+Ajax
http://897371388.iteye.com/blog/1975351 大致思路也就是下面,由于最近在学Laravel也在学Angularjs,加上之前做的项目用到了d3. 原来的方案如下: ...
随机推荐
- Java基础08 继承
作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢! 继承(inheritance)是面向对象的重要概念.继承是除组合(composit ...
- EF架构使用随机排序
c#当中,可以用Random类来获取随机数 EF当中,我们写Linq时,抑或是采用Linq的扩展方法时,发现都没有随机排序的方法,这就要求我们自己去扩展了 引用自http://www.cnblogs. ...
- D16Pascal的编译器和IDE
https://github.com/Memnarch/D16Pascal https://github.com/Memnarch/D16IDE https://github.com/Memnarch ...
- 基于visual Studio2013解决C语言竞赛题之1031猜数
题目 解决代码及点评 /* 31. 猜号码∶由随机函数产生一个1至1000之间的整数,让人猜之. 计算机仅回答人猜的数大.小还是相等,当人猜对时, 由计算机打印出人 ...
- 操作3 mongodb和mysql 开启慢查询日志 ，以及mongodb从配置文件启动
1. mongodb从配置文件启动 创建配置文件:/usr/local/mongodb/etc/mongodb.conf 配置文件的内容为: #Directory and relavent set d ...
- LPCTSTR
LPCTSTR类型: L表示long指针 这是为了兼容Windows 3.1等16位操作系统遗留下来的,在win32中以及其他的32位操作系统中, long指针和near指针及far修饰符都是为了兼容 ...
- Cocos2d-x 学习（1）—— 通过Cocos Studio创建第一个Demo
近期在工作上有了比較大的转变,自学情绪也慢慢高涨,本来一直在研究unity的技术.由于换了工作会開始接触cocos2d-x.但并不意味着停止研究unity,以后有时间还是会继续的. 公司的cocos2 ...
- Sprite Kit教程：制作一个通用程序 2
注1:本文译自Sprite Kit Tutorial: Making a Universal App: Part 2 目录 动画的定义:可行性 属性列表 添加游戏逻辑 添加音效 何去何从 上一篇文章中 ...
- eval 捕获错误
eval 捕获错误: [root@dr-mysql01 ~]# cat t1.pl use DBI; my $dbUser='zabbix'; my $user="root"; m ...
- 【Cocos2d-X游戏实战开发】捕鱼达人之开发前准备工作（一）
本系列学习教程使用的是cocos2d-x-2.1.4(最新版为cocos2d-x-2.1.5) 博主发现前两个系列的学习教程被严重抄袭,在这里呼吁大家请尊重开发者的劳动成果, 转载的时候请务必注明出处 ...