npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@axway/api-builder-plugin-dc-mongo

v2.0.0

Published

MongoDB plugin

Downloads

94

Readme

MongoDB Connector

The MongoDB data connector is a plugin for API Builder that can connect to your MongoDB instance and interrogate your schema that will automatically provision Models into to your application, and optionally, automatically generate a rich CRUD API to the underlying tables. The Models can be used programmatically, or can be used within the flow editor to interact with your database.

Minimum requirements

Supported versions

  • MongoDB 3.6

Memory

  • ~10 MB

Disk space

  • ~14 MB

Supported features

  • Automatic generation of Models from MongoDB collections
  • Automatic generation of API for Models
  • Full CRUD operations on tables via Models

Installation

npm install --no-optional @axway/api-builder-plugin-dc-mongo

A configuration file is generated for you and placed into the conf directory of your API Builder project. By default, we use a host of localhost, and a table called apibuilder.

Configuration

Once the plugin is installed, the configuration file is located <project>/conf/mongo.default.conf.

| Option name | Type | Description | | ----------- | ---- | ----------- | | connector | string | Must be: @axway/api-builder-plugin-dc-mongo | | url | string | The MongoDB database URL. | | generateModelsFromSchema | boolean | If enabled, API Builder will automatically interrogate the database and auto-generate Models from MongoDB collections. | | modelAutogen | boolean | If enabled, API Builder will automatically generate a full and rich CRUD API from the generated Models. |

Usage

After you configure the connector, you can start up your API Builder project and visit the console (normally found under http://localhost:8080/console). Your connector will be listed under the Connectors section of the console.

Your MongoDB collections will be listed under the Models section of the console. You can now click on the gear icon to the right of the table names and generate flow based APIs.

You can also reference the connector in a custom model.

var User = APIBuilder.Model.extend('user', {
	fields: {
		name: { type: String, required: false, validator: /[a-zA-Z]{3,}/ }
	},
	connector: 'mongo'
});

If you want to map a specific model to a specific collection name, use metadata. For example, to map the user model to the collection users, set it such as:

var User = APIBuilder.Model.extend('user', {
	fields: {
		name: { type: String, required: false, validator: /[a-zA-Z]{3,}/ }
	},
	connector: 'mongo',
	metadata: {
		'mongo': {
			collection: 'users'
		}
	}
});

Known issues and limitations

None

Changes

2.0.0

  • #6089: Breaking change: requires minimum Node.js version 16.x.

1.2.2

  • #7412: Pin in-house dependencies.

1.2.1

1.2.0

  • #6933: Replace peerDependency on @axway/api-builder-runtime with engines.apibuilder.

1.1.16

  • #7008: Fixed the issue where the plugin configuration file is not installed correctly if the project conf directory does not exist.

1.1.15

  • #6815: Internal tooling changes.

1.1.14

1.1.13

  • #6315: Internal chore.

1.1.12

  • #6116: Internal cleanup chore.

1.1.11

  • #6115: Internal fix for Sonar scans.

1.1.10

  • #6074: Internal CI chore

1.1.9

  • #5711: Internal cleanup of npm scripts.

1.1.8

  • #5715: Internal changes to remove integration tests.

1.1.7

  • #5709: Internal changes to update eslint rules.

1.1.6

  • #5707: Internal cleanup to code coverage during build process.

1.1.2

  • #5050: Updating license text.

1.1.0

  • #4532: Data connectors table methods did not display the proper type for the PK Previously, APIs and flows generated for models based created by data connectors assumed a IDs were of type string. Now, the APIs and flows will use the proper type for the primary key.

1.0.3

  • #4757: Changed SCM repository and associated internal cleanup.

License

This code is proprietary, closed source software licensed to you by Axway. All Rights Reserved. You may not modify Axway’s code without express written permission of Axway. You are licensed to use and distribute your services developed with the use of this software and dependencies, including distributing reasonable and appropriate portions of the Axway code and dependencies. Except as set forth above, this code MUST not be copied or otherwise redistributed without express written permission of Axway. This module is licensed as part of the Axway Platform and governed under the terms of the Axway license agreement (General Conditions) located here: https://support.axway.com/en/auth/general-conditions; EXCEPT THAT IF YOU RECEIVED A FREE SUBSCRIPTION, LICENSE, OR SUPPORT SUBSCRIPTION FOR THIS CODE, NOTWITHSTANDING THE LANGUAGE OF THE GENERAL CONDITIONS, AXWAY HEREBY DISCLAIMS ALL SUPPORT AND MAINTENANCE OBLIGATIONS, AS WELL AS ALL EXPRESS AND IMPLIED WARRANTIES, INCLUDING BUT NOT LIMITED TO IMPLIED INFRINGEMENT WARRANTIES, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, AND YOU ACCEPT THE PRODUCT AS-IS AND WITH ALL FAULTS, SOLELY AT YOUR OWN RISK. Your right to use this software is strictly limited to the term (if any) of the license or subscription originally granted to you.