quickcorp/qcobjects

QCObjects 镜像文档

镜像概述

QCObjects是一个开源框架，旨在赋能全栈开发者构建基于N层架构的微服务和微前端应用。通过统一的纯JavaScript语法，开发者可同时进行前端和后端开发，实现跨浏览器、跨平台和跨框架的应用开发。该框架支持MVC模式、动态组件架构，并内置HTTP2服务器，适用于构建Progressive Web Apps (PWA)和Accelerated Mobile Pages (AMP)等现代应用。

核心功能与特性

主要功能

• N层架构支持：将微服务和微前端整合为N层架构，实现清晰的分层设计
• 全栈JavaScript开发：使用纯JavaScript统一开发前后端，无需额外transpiler
• 动态组件架构：支持嵌套组件管理和递归路由，组件可动态加载和卸载
• MVC模式集成：内置Model-View-Controller模式，简化应用结构
• PWA/AMP支持：提供PWA和AMP的内置模板，支持懒加载、按需资源加载等特性

PWA特性

• 防止渲染阻塞资源：通过Package工厂函数优化资源加载
• 按需资源加载：组件动态渲染时加载资源，减少不必要的网络请求
• 图片懒加载：使用lazy-src属性替代src，结合Intersection Observer API实现高效图片加载

使用场景与适用范围

• 全栈应用开发：需要统一前后端开发语言和架构的项目
• 微服务与微前端：构建松耦合、可扩展的微服务和微前端架构
• PWA/AMP开发：开发高性能、跨平台的渐进式Web应用和加速移动页面
• MVC应用：需要清晰分层架构的Web应用

安装与使用方法

Docker镜像安装

bash
# 拉取QCObjects playground镜像
docker pull quickcorp/qcobjects-playground

运行Docker容器

bash
# 启动容器，映射端口8080
docker run -d -p 8080:8080 --name qcobjects-app quickcorp/qcobjects-playground

基本使用示例

快速创建PWA应用

通过容器内的QCObjects CLI工具快速创建PWA项目：

bash
# 进入容器
docker exec -it qcobjects-app /bin/bash

# 创建PWA项目
qcobjects create --pwa my-pwa-app
cd my-pwa-app

# 启动开发服务器
qcobjects serve

访问 http://localhost:8080 即可查看运行中的PWA应用。

组件开发示例

创建一个简单的自定义组件：

javascript
// 定义组件类
Class('MyComponent', Component, {
  template: '<div>Hello QCObjects!</div>',
  style: '.my-component { color: blue; }'
});

// 在页面中使用
var component = New(MyComponent);
document.body.append(component);

配置说明

核心配置文件

项目根目录下的config.json用于配置应用行为，主要配置项包括：

• backend：后端服务设置（端口、HTTPS配置等）
• components：组件路径和加载策略
• routes：路由规则定义
• packages：依赖包配置

环境变量

• NODE_ENV：环境类型（development/production）
• PORT：服务端口（默认8080）
• HTTPS：是否启用HTTPS（true/false）

相关资源

• 官方文档：[***]
• GitHub仓库：https://github.com/QuickCorp/QCObjects
• PWA示例：[***]