mongo 1.12.5 → 2.0.0.beta
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +0 -0
- data.tar.gz.sig +0 -0
- data/CONTRIBUTING.md +64 -0
- data/LICENSE +1 -1
- data/README.md +23 -125
- data/Rakefile +26 -21
- data/bin/mongo_console +6 -38
- data/lib/mongo.rb +23 -82
- data/lib/mongo/address.rb +111 -0
- data/lib/mongo/address/ipv4.rb +85 -0
- data/lib/mongo/address/ipv6.rb +85 -0
- data/lib/mongo/address/unix.rb +76 -0
- data/lib/mongo/auth.rb +108 -0
- data/lib/mongo/auth/cr.rb +44 -0
- data/lib/mongo/auth/cr/conversation.rb +119 -0
- data/lib/mongo/auth/executable.rb +52 -0
- data/lib/mongo/auth/ldap.rb +48 -0
- data/lib/mongo/auth/ldap/conversation.rb +92 -0
- data/lib/mongo/auth/roles.rb +104 -0
- data/lib/mongo/auth/scram.rb +53 -0
- data/lib/mongo/auth/scram/conversation.rb +450 -0
- data/lib/mongo/auth/user.rb +159 -0
- data/lib/mongo/auth/user/view.rb +102 -0
- data/lib/mongo/auth/x509.rb +48 -0
- data/lib/mongo/auth/x509/conversation.rb +92 -0
- data/lib/mongo/{gridfs.rb → bulk.rb} +2 -5
- data/lib/mongo/bulk/bulk_write.rb +307 -0
- data/lib/mongo/client.rb +233 -0
- data/lib/mongo/cluster.rb +203 -0
- data/lib/mongo/cluster/topology.rb +60 -0
- data/lib/mongo/cluster/topology/replica_set.rb +160 -0
- data/lib/mongo/cluster/topology/sharded.rb +132 -0
- data/lib/mongo/cluster/topology/standalone.rb +132 -0
- data/lib/mongo/cluster/topology/unknown.rb +155 -0
- data/lib/mongo/collection.rb +130 -1101
- data/lib/mongo/collection/view.rb +169 -0
- data/lib/mongo/collection/view/aggregation.rb +108 -0
- data/lib/mongo/collection/view/explainable.rb +49 -0
- data/lib/mongo/collection/view/immutable.rb +43 -0
- data/lib/mongo/collection/view/iterable.rb +48 -0
- data/lib/mongo/collection/view/map_reduce.rb +191 -0
- data/lib/mongo/collection/view/readable.rb +363 -0
- data/lib/mongo/collection/view/writable.rb +169 -0
- data/lib/mongo/cursor.rb +79 -680
- data/lib/mongo/database.rb +224 -0
- data/lib/mongo/database/view.rb +101 -0
- data/lib/mongo/error.rb +81 -0
- data/lib/mongo/error/bulk_write_failure.rb +41 -0
- data/lib/mongo/{utils/thread_local_variable_manager.rb → error/empty_batch.rb} +22 -8
- data/{test/functional/db_connection_test.rb → lib/mongo/error/invalid_bulk_operation.rb} +19 -8
- data/lib/mongo/error/invalid_collection_name.rb +39 -0
- data/lib/mongo/error/invalid_database_name.rb +39 -0
- data/{test/replica_set/ssl_test.rb → lib/mongo/error/invalid_document.rb} +21 -14
- data/lib/mongo/error/invalid_file.rb +38 -0
- data/lib/mongo/error/invalid_nonce.rb +46 -0
- data/lib/mongo/error/invalid_replacement_document.rb +39 -0
- data/lib/mongo/error/invalid_signature.rb +47 -0
- data/{test/functional/ssl_test.rb → lib/mongo/error/invalid_update_document.rb} +22 -12
- data/lib/mongo/error/max_bson_size.rb +40 -0
- data/lib/mongo/error/max_message_size.rb +42 -0
- data/lib/mongo/{utils.rb → error/need_primary_server.rb} +10 -6
- data/lib/mongo/{connection.rb → error/operation_failure.rb} +10 -6
- data/lib/mongo/error/parser.rb +77 -0
- data/lib/mongo/{connection/socket.rb → error/socket_error.rb} +10 -5
- data/lib/mongo/error/socket_timeout_error.rb +23 -0
- data/lib/mongo/error/unsupported_features.rb +43 -0
- data/lib/mongo/event.rb +40 -0
- data/lib/mongo/event/listeners.rb +63 -0
- data/lib/mongo/event/primary_elected.rb +53 -0
- data/lib/mongo/event/publisher.rb +42 -0
- data/lib/mongo/event/server_added.rb +53 -0
- data/lib/mongo/event/server_removed.rb +53 -0
- data/lib/mongo/event/subscriber.rb +41 -0
- data/lib/mongo/grid.rb +16 -0
- data/lib/mongo/grid/file.rb +94 -0
- data/lib/mongo/grid/file/chunk.rb +184 -0
- data/lib/mongo/grid/file/metadata.rb +223 -0
- data/lib/mongo/grid/fs.rb +149 -0
- data/lib/mongo/index.rb +64 -0
- data/lib/mongo/index/view.rb +205 -0
- data/lib/mongo/loggable.rb +126 -0
- data/lib/mongo/logger.rb +132 -0
- data/lib/mongo/operation.rb +26 -0
- data/lib/mongo/operation/aggregate.rb +100 -0
- data/lib/mongo/operation/aggregate/result.rb +84 -0
- data/lib/mongo/operation/batchable.rb +103 -0
- data/lib/mongo/operation/bulk_delete/result.rb +197 -0
- data/lib/mongo/operation/bulk_insert/result.rb +195 -0
- data/lib/mongo/operation/bulk_update/result.rb +295 -0
- data/lib/mongo/operation/command.rb +62 -0
- data/lib/mongo/operation/executable.rb +105 -0
- data/lib/mongo/operation/kill_cursors.rb +39 -0
- data/lib/mongo/operation/limited.rb +37 -0
- data/lib/mongo/operation/list_collections/result.rb +116 -0
- data/lib/mongo/operation/list_indexes/result.rb +118 -0
- data/lib/mongo/operation/map_reduce.rb +96 -0
- data/lib/mongo/operation/map_reduce/result.rb +122 -0
- data/lib/mongo/{functional.rb → operation/read.rb} +7 -7
- data/lib/mongo/operation/read/collections_info.rb +67 -0
- data/lib/mongo/operation/read/get_more.rb +71 -0
- data/lib/mongo/operation/read/indexes.rb +68 -0
- data/lib/mongo/operation/read/list_collections.rb +75 -0
- data/lib/mongo/operation/read/list_indexes.rb +77 -0
- data/lib/mongo/operation/read/query.rb +71 -0
- data/lib/mongo/operation/read_preferrable.rb +34 -0
- data/lib/mongo/operation/result.rb +259 -0
- data/lib/mongo/operation/specifiable.rb +380 -0
- data/lib/mongo/operation/write.rb +25 -0
- data/lib/mongo/operation/write/bulk_delete.rb +158 -0
- data/lib/mongo/operation/write/bulk_insert.rb +160 -0
- data/lib/mongo/operation/write/bulk_update.rb +167 -0
- data/lib/mongo/{connection/socket/socket_util.rb → operation/write/command.rb} +9 -24
- data/lib/mongo/operation/write/command/create_user.rb +43 -0
- data/lib/mongo/operation/write/command/delete.rb +56 -0
- data/lib/mongo/operation/write/command/drop_index.rb +51 -0
- data/lib/mongo/operation/write/command/ensure_index.rb +55 -0
- data/lib/mongo/operation/write/command/insert.rb +55 -0
- data/lib/mongo/operation/write/command/remove_user.rb +42 -0
- data/lib/mongo/operation/write/command/update.rb +60 -0
- data/lib/mongo/operation/write/command/writable.rb +61 -0
- data/lib/mongo/operation/write/create_index.rb +84 -0
- data/lib/mongo/operation/write/create_user.rb +75 -0
- data/lib/mongo/operation/write/delete.rb +91 -0
- data/lib/mongo/operation/write/drop_index.rb +62 -0
- data/lib/mongo/operation/write/insert.rb +88 -0
- data/lib/mongo/operation/write/remove_user.rb +70 -0
- data/lib/mongo/operation/write/update.rb +98 -0
- data/lib/mongo/protocol.rb +15 -0
- data/lib/mongo/protocol/bit_vector.rb +61 -0
- data/lib/mongo/protocol/delete.rb +94 -0
- data/lib/mongo/protocol/get_more.rb +99 -0
- data/lib/mongo/protocol/insert.rb +99 -0
- data/lib/mongo/protocol/kill_cursors.rb +74 -0
- data/lib/mongo/protocol/message.rb +252 -0
- data/lib/mongo/protocol/query.rb +147 -0
- data/lib/mongo/protocol/reply.rb +72 -0
- data/lib/mongo/protocol/serializers.rb +180 -0
- data/lib/mongo/protocol/update.rb +111 -0
- data/lib/mongo/server.rb +163 -0
- data/lib/mongo/server/connectable.rb +99 -0
- data/lib/mongo/server/connection.rb +133 -0
- data/lib/mongo/server/connection_pool.rb +141 -0
- data/lib/mongo/server/connection_pool/queue.rb +182 -0
- data/lib/mongo/server/context.rb +66 -0
- data/lib/mongo/server/description.rb +450 -0
- data/lib/mongo/server/description/features.rb +85 -0
- data/lib/mongo/server/description/inspector.rb +79 -0
- data/lib/mongo/server/description/inspector/primary_elected.rb +58 -0
- data/lib/mongo/server/description/inspector/server_added.rb +59 -0
- data/lib/mongo/server/description/inspector/server_removed.rb +59 -0
- data/lib/mongo/server/monitor.rb +160 -0
- data/lib/mongo/server/monitor/connection.rb +88 -0
- data/lib/mongo/server_selector.rb +81 -0
- data/lib/mongo/server_selector/nearest.rb +94 -0
- data/lib/mongo/server_selector/primary.rb +88 -0
- data/lib/mongo/server_selector/primary_preferred.rb +94 -0
- data/lib/mongo/server_selector/secondary.rb +91 -0
- data/lib/mongo/server_selector/secondary_preferred.rb +96 -0
- data/lib/mongo/server_selector/selectable.rb +209 -0
- data/lib/mongo/socket.rb +179 -0
- data/lib/mongo/socket/ssl.rb +108 -0
- data/lib/mongo/socket/tcp.rb +69 -0
- data/lib/mongo/socket/unix.rb +66 -0
- data/lib/mongo/uri.rb +504 -0
- data/lib/mongo/version.rb +21 -0
- data/lib/mongo/write_concern.rb +99 -0
- data/lib/mongo/write_concern/acknowledged.rb +38 -0
- data/lib/mongo/write_concern/normalizable.rb +73 -0
- data/lib/mongo/write_concern/unacknowledged.rb +43 -0
- data/mongo.gemspec +17 -14
- data/spec/mongo/address/ipv4_spec.rb +74 -0
- data/spec/mongo/address/ipv6_spec.rb +74 -0
- data/spec/mongo/address/unix_spec.rb +30 -0
- data/spec/mongo/address_spec.rb +206 -0
- data/spec/mongo/auth/cr_spec.rb +59 -0
- data/spec/mongo/auth/ldap_spec.rb +40 -0
- data/spec/mongo/auth/scram/conversation_spec.rb +197 -0
- data/spec/mongo/auth/scram_spec.rb +55 -0
- data/spec/mongo/auth/user/view_spec.rb +76 -0
- data/spec/mongo/auth/user_spec.rb +190 -0
- data/spec/mongo/auth/x509_spec.rb +40 -0
- data/spec/mongo/auth_spec.rb +65 -0
- data/spec/mongo/bulk/bulk_write_spec.rb +175 -0
- data/spec/mongo/client_spec.rb +564 -0
- data/spec/mongo/cluster/topology/replica_set_spec.rb +101 -0
- data/spec/mongo/cluster/topology/sharded_spec.rb +74 -0
- data/spec/mongo/cluster/topology/standalone_spec.rb +79 -0
- data/spec/mongo/cluster/topology_spec.rb +65 -0
- data/spec/mongo/cluster_spec.rb +129 -0
- data/spec/mongo/collection/view/aggregation_spec.rb +135 -0
- data/spec/mongo/collection/view/explainable_spec.rb +32 -0
- data/spec/mongo/collection/view/map_reduce_spec.rb +242 -0
- data/spec/mongo/collection/view/readable_spec.rb +603 -0
- data/spec/mongo/collection/view/writable_spec.rb +504 -0
- data/spec/mongo/collection/view_spec.rb +521 -0
- data/spec/mongo/collection_spec.rb +362 -0
- data/spec/mongo/cursor_spec.rb +295 -0
- data/spec/mongo/database_spec.rb +306 -0
- data/spec/mongo/error/parser_spec.rb +119 -0
- data/spec/mongo/event/publisher_spec.rb +50 -0
- data/spec/mongo/event/subscriber_spec.rb +34 -0
- data/spec/mongo/grid/file/chunk_spec.rb +226 -0
- data/spec/mongo/grid/file/metadata_spec.rb +69 -0
- data/spec/mongo/grid/file_spec.rb +138 -0
- data/spec/mongo/grid/fs_spec.rb +129 -0
- data/spec/mongo/index/view_spec.rb +226 -0
- data/spec/mongo/loggable_spec.rb +62 -0
- data/spec/mongo/logger_spec.rb +97 -0
- data/spec/mongo/operation/aggregate/result_spec.rb +80 -0
- data/spec/mongo/operation/aggregate_spec.rb +135 -0
- data/spec/mongo/operation/command_spec.rb +106 -0
- data/spec/mongo/operation/kill_cursors_spec.rb +66 -0
- data/spec/mongo/operation/limited_spec.rb +50 -0
- data/spec/mongo/operation/map_reduce_spec.rb +143 -0
- data/spec/mongo/operation/read/collections_info_spec.rb +40 -0
- data/spec/mongo/operation/read/get_more_spec.rb +81 -0
- data/spec/mongo/operation/read/indexes_spec.rb +31 -0
- data/spec/mongo/operation/read/query_spec.rb +84 -0
- data/spec/mongo/operation/result_spec.rb +275 -0
- data/spec/mongo/operation/specifiable_spec.rb +53 -0
- data/spec/mongo/operation/write/bulk_delete_spec.rb +473 -0
- data/spec/mongo/operation/write/bulk_insert_spec.rb +466 -0
- data/spec/mongo/operation/write/bulk_update_spec.rb +524 -0
- data/spec/mongo/operation/write/command/delete_spec.rb +116 -0
- data/spec/mongo/operation/write/command/insert_spec.rb +117 -0
- data/spec/mongo/operation/write/command/update_spec.rb +123 -0
- data/spec/mongo/operation/write/create_user_spec.rb +44 -0
- data/spec/mongo/operation/write/delete_spec.rb +178 -0
- data/spec/mongo/operation/write/drop_index_spec.rb +51 -0
- data/spec/mongo/operation/write/ensure_index_spec.rb +81 -0
- data/spec/mongo/operation/write/insert_spec.rb +231 -0
- data/spec/mongo/operation/write/remove_user_spec.rb +46 -0
- data/spec/mongo/operation/write/response_spec.rb +85 -0
- data/spec/mongo/operation/write/update_spec.rb +177 -0
- data/spec/mongo/protocol/delete_spec.rb +167 -0
- data/spec/mongo/protocol/get_more_spec.rb +146 -0
- data/spec/mongo/protocol/insert_spec.rb +161 -0
- data/spec/mongo/protocol/kill_cursors_spec.rb +101 -0
- data/spec/mongo/protocol/query_spec.rb +285 -0
- data/spec/mongo/protocol/reply_spec.rb +157 -0
- data/spec/mongo/protocol/update_spec.rb +186 -0
- data/spec/mongo/server/connection_pool/queue_spec.rb +170 -0
- data/spec/mongo/server/connection_pool_spec.rb +120 -0
- data/spec/mongo/server/connection_spec.rb +289 -0
- data/spec/mongo/server/description/features_spec.rb +138 -0
- data/spec/mongo/server/description/inspector/primary_elected_spec.rb +94 -0
- data/spec/mongo/server/description/inspector/server_added_spec.rb +92 -0
- data/spec/mongo/server/description/inspector/server_removed_spec.rb +95 -0
- data/spec/mongo/server/description_spec.rb +510 -0
- data/spec/mongo/server/monitor_spec.rb +130 -0
- data/spec/mongo/server_discovery_and_monitoring_spec.rb +103 -0
- data/spec/mongo/server_selection_rtt_spec.rb +104 -0
- data/spec/mongo/server_selection_spec.rb +89 -0
- data/spec/mongo/server_selector/nearest_spec.rb +250 -0
- data/spec/mongo/server_selector/primary_preferred_spec.rb +290 -0
- data/spec/mongo/server_selector/primary_spec.rb +114 -0
- data/spec/mongo/server_selector/secondary_preferred_spec.rb +252 -0
- data/spec/mongo/server_selector/secondary_spec.rb +196 -0
- data/spec/mongo/server_selector_spec.rb +101 -0
- data/spec/mongo/server_spec.rb +131 -0
- data/spec/mongo/uri_spec.rb +517 -0
- data/spec/mongo/write_concern/acknowledged_spec.rb +44 -0
- data/spec/mongo/write_concern/unacknowledged_spec.rb +15 -0
- data/spec/mongo_orchestration_spec.rb +70 -0
- data/spec/spec_helper.rb +148 -0
- data/spec/support/authorization.rb +245 -0
- data/spec/support/helpers.rb +140 -0
- data/spec/support/matchers.rb +37 -0
- data/spec/support/mongo_orchestration.rb +61 -0
- data/spec/support/mongo_orchestration/requestable.rb +109 -0
- data/spec/support/mongo_orchestration/standalone.rb +57 -0
- data/spec/support/sdam/rs/discover_arbiters.yml +41 -0
- data/spec/support/sdam/rs/discover_passives.yml +41 -0
- data/spec/support/sdam/rs/discover_primary.yml +40 -0
- data/spec/support/sdam/rs/discover_secondary.yml +41 -0
- data/spec/support/sdam/rs/discovery.yml +195 -0
- data/spec/support/sdam/rs/ghost_discovered.yml +39 -0
- data/spec/support/sdam/rs/hosts_differ_from_seeds.yml +34 -0
- data/spec/support/sdam/rs/member_reconfig.yml +68 -0
- data/spec/support/sdam/rs/member_standalone.yml +60 -0
- data/spec/support/sdam/rs/new_primary.yml +74 -0
- data/spec/support/sdam/rs/new_primary_wrong_set_name.yml +71 -0
- data/spec/support/sdam/rs/non_rs_member.yml +31 -0
- data/spec/support/sdam/rs/normalize_case.yml +49 -0
- data/spec/support/sdam/rs/primary_becomes_standalone.yml +52 -0
- data/spec/support/sdam/rs/primary_changes_set_name.yml +57 -0
- data/spec/support/sdam/rs/primary_disconnect.yml +56 -0
- data/spec/support/sdam/rs/primary_wrong_set_name.yml +27 -0
- data/spec/support/sdam/rs/response_from_removed.yml +63 -0
- data/spec/support/sdam/rs/rsother_discovered.yml +41 -0
- data/spec/support/sdam/rs/sec_not_auth.yml +49 -0
- data/spec/support/sdam/rs/secondary_wrong_set_name.yml +28 -0
- data/spec/support/sdam/rs/secondary_wrong_set_name_with_primary.yml +69 -0
- data/spec/support/sdam/rs/unexpected_mongos.yml +26 -0
- data/spec/support/sdam/rs/wrong_set_name.yml +35 -0
- data/spec/support/sdam/sharded/multiple_mongoses.yml +46 -0
- data/spec/support/sdam/sharded/non_mongos_removed.yml +41 -0
- data/spec/support/sdam/sharded/normalize_uri_case.yml +32 -0
- data/spec/support/sdam/single/direct_connection_external_ip.yml +34 -0
- data/spec/support/sdam/single/direct_connection_mongos.yml +33 -0
- data/spec/support/sdam/single/direct_connection_rsarbiter.yml +35 -0
- data/spec/support/sdam/single/direct_connection_rsprimary.yml +34 -0
- data/spec/support/sdam/single/direct_connection_rssecondary.yml +35 -0
- data/spec/support/sdam/single/direct_connection_slave.yml +32 -0
- data/spec/support/sdam/single/direct_connection_standalone.yml +32 -0
- data/spec/support/sdam/single/not_ok_response.yml +39 -0
- data/spec/support/sdam/single/standalone_removed.yml +32 -0
- data/spec/support/sdam/single/unavailable_seed.yml +28 -0
- data/spec/support/server_discovery_and_monitoring.rb +167 -0
- data/spec/support/server_selection.rb +140 -0
- data/spec/support/server_selection/rtt/first_value.yml +4 -0
- data/spec/support/server_selection/rtt/first_value_zero.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_1.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_2.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_3.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_4.yml +4 -0
- data/spec/support/server_selection/rtt/value_test_5.yml +4 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest.yml +32 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Nearest_non_matching.yml +27 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Primary.yml +23 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/PrimaryPreferred.yml +32 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/PrimaryPreferred_non_matching.yml +27 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Secondary.yml +32 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/SecondaryPreferred.yml +32 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/SecondaryPreferred_non_matching.yml +27 -0
- data/spec/support/server_selection/selection/ReplicaSetNoPrimary/read/Secondary_non_matching.yml +27 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Nearest.yml +41 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Nearest_non_matching.yml +34 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/Primary.yml +33 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/PrimaryPreferred.yml +39 -0
- data/spec/support/server_selection/selection/ReplicaSetWithPrimary/read/PrimaryPreferred_non_matching.yml +36 -0
- data/spec/support/server_selection/selection/Sharded/read/SecondaryPreferred.yml +32 -0
- data/spec/support/server_selection/selection/Single/read/SecondaryPreferred.yml +23 -0
- data/spec/support/server_selection/selection/Unknown/read/SecondaryPreferred.yml +13 -0
- data/spec/support/server_selection_rtt.rb +41 -0
- data/spec/support/shared/bulk_write.rb +498 -0
- data/spec/support/shared/cursor.rb +38 -0
- data/spec/support/shared/operation.rb +77 -0
- data/spec/support/shared/protocol.rb +31 -0
- data/spec/support/shared/server_selector.rb +111 -0
- data/spec/support/shared/socket.rb +82 -0
- data/spec/support/travis.rb +14 -0
- metadata +523 -189
- metadata.gz.sig +0 -0
- data/VERSION +0 -1
- data/lib/mongo/bulk_write_collection_view.rb +0 -387
- data/lib/mongo/collection_writer.rb +0 -364
- data/lib/mongo/connection/node.rb +0 -249
- data/lib/mongo/connection/pool.rb +0 -340
- data/lib/mongo/connection/pool_manager.rb +0 -320
- data/lib/mongo/connection/sharding_pool_manager.rb +0 -67
- data/lib/mongo/connection/socket/ssl_socket.rb +0 -95
- data/lib/mongo/connection/socket/tcp_socket.rb +0 -87
- data/lib/mongo/connection/socket/unix_socket.rb +0 -39
- data/lib/mongo/db.rb +0 -808
- data/lib/mongo/exception.rb +0 -145
- data/lib/mongo/functional/authentication.rb +0 -455
- data/lib/mongo/functional/logging.rb +0 -85
- data/lib/mongo/functional/read_preference.rb +0 -183
- data/lib/mongo/functional/scram.rb +0 -556
- data/lib/mongo/functional/uri_parser.rb +0 -409
- data/lib/mongo/functional/write_concern.rb +0 -66
- data/lib/mongo/gridfs/grid.rb +0 -112
- data/lib/mongo/gridfs/grid_ext.rb +0 -53
- data/lib/mongo/gridfs/grid_file_system.rb +0 -163
- data/lib/mongo/gridfs/grid_io.rb +0 -484
- data/lib/mongo/legacy.rb +0 -140
- data/lib/mongo/mongo_client.rb +0 -697
- data/lib/mongo/mongo_replica_set_client.rb +0 -535
- data/lib/mongo/mongo_sharded_client.rb +0 -159
- data/lib/mongo/networking.rb +0 -372
- data/lib/mongo/utils/conversions.rb +0 -110
- data/lib/mongo/utils/core_ext.rb +0 -70
- data/lib/mongo/utils/server_version.rb +0 -69
- data/lib/mongo/utils/support.rb +0 -80
- data/test/functional/authentication_test.rb +0 -39
- data/test/functional/bulk_api_stress_test.rb +0 -133
- data/test/functional/bulk_write_collection_view_test.rb +0 -1198
- data/test/functional/client_test.rb +0 -627
- data/test/functional/collection_test.rb +0 -2175
- data/test/functional/collection_writer_test.rb +0 -83
- data/test/functional/conversions_test.rb +0 -163
- data/test/functional/cursor_fail_test.rb +0 -57
- data/test/functional/cursor_message_test.rb +0 -56
- data/test/functional/cursor_test.rb +0 -683
- data/test/functional/db_api_test.rb +0 -835
- data/test/functional/db_test.rb +0 -348
- data/test/functional/grid_file_system_test.rb +0 -285
- data/test/functional/grid_io_test.rb +0 -252
- data/test/functional/grid_test.rb +0 -273
- data/test/functional/pool_test.rb +0 -136
- data/test/functional/safe_test.rb +0 -98
- data/test/functional/support_test.rb +0 -62
- data/test/functional/timeout_test.rb +0 -60
- data/test/functional/uri_test.rb +0 -446
- data/test/functional/write_concern_test.rb +0 -118
- data/test/helpers/general.rb +0 -50
- data/test/helpers/test_unit.rb +0 -476
- data/test/replica_set/authentication_test.rb +0 -37
- data/test/replica_set/basic_test.rb +0 -189
- data/test/replica_set/client_test.rb +0 -393
- data/test/replica_set/connection_test.rb +0 -138
- data/test/replica_set/count_test.rb +0 -66
- data/test/replica_set/cursor_test.rb +0 -220
- data/test/replica_set/insert_test.rb +0 -157
- data/test/replica_set/max_values_test.rb +0 -151
- data/test/replica_set/pinning_test.rb +0 -105
- data/test/replica_set/query_test.rb +0 -73
- data/test/replica_set/read_preference_test.rb +0 -219
- data/test/replica_set/refresh_test.rb +0 -211
- data/test/replica_set/replication_ack_test.rb +0 -95
- data/test/sharded_cluster/basic_test.rb +0 -203
- data/test/shared/authentication/basic_auth_shared.rb +0 -260
- data/test/shared/authentication/bulk_api_auth_shared.rb +0 -249
- data/test/shared/authentication/gssapi_shared.rb +0 -176
- data/test/shared/authentication/sasl_plain_shared.rb +0 -96
- data/test/shared/authentication/scram_shared.rb +0 -92
- data/test/shared/ssl_shared.rb +0 -235
- data/test/test_helper.rb +0 -61
- data/test/threading/basic_test.rb +0 -120
- data/test/tools/mongo_config.rb +0 -708
- data/test/tools/mongo_config_test.rb +0 -160
- data/test/unit/client_test.rb +0 -381
- data/test/unit/collection_test.rb +0 -166
- data/test/unit/connection_test.rb +0 -335
- data/test/unit/cursor_test.rb +0 -307
- data/test/unit/db_test.rb +0 -136
- data/test/unit/grid_test.rb +0 -76
- data/test/unit/mongo_sharded_client_test.rb +0 -48
- data/test/unit/node_test.rb +0 -93
- data/test/unit/pool_manager_test.rb +0 -111
- data/test/unit/read_pref_test.rb +0 -406
- data/test/unit/read_test.rb +0 -159
- data/test/unit/safe_test.rb +0 -158
- data/test/unit/sharding_pool_manager_test.rb +0 -84
- data/test/unit/write_concern_test.rb +0 -175
@@ -0,0 +1,363 @@
|
|
1
|
+
# Copyright (C) 2014-2015 MongoDB, Inc.
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
module Mongo
|
16
|
+
class Collection
|
17
|
+
class View
|
18
|
+
|
19
|
+
# Defines read related behaviour for collection view.
|
20
|
+
#
|
21
|
+
# @since 2.0.0
|
22
|
+
module Readable
|
23
|
+
|
24
|
+
# Special fields and their getters for the query selector.
|
25
|
+
#
|
26
|
+
# @since 2.0.0
|
27
|
+
SPECIAL_FIELDS = {
|
28
|
+
:$query => :selector,
|
29
|
+
:$readPreference => :read_pref_formatted,
|
30
|
+
:$orderby => :sort,
|
31
|
+
:$hint => :hint,
|
32
|
+
:$comment => :comment,
|
33
|
+
:$snapshot => :snapshot,
|
34
|
+
:$maxScan => :max_scan,
|
35
|
+
:$showDiskLoc => :show_disk_loc,
|
36
|
+
:$explain => :explained?
|
37
|
+
}.freeze
|
38
|
+
|
39
|
+
# Execute an aggregation on the collection view.
|
40
|
+
#
|
41
|
+
# @example Aggregate documents.
|
42
|
+
# view.aggregate([
|
43
|
+
# { "$group" => { "_id" => "$city", "tpop" => { "$sum" => "$pop" }}}
|
44
|
+
# ])
|
45
|
+
#
|
46
|
+
# @param [ Array<Hash> ] pipeline The aggregation pipeline.
|
47
|
+
# @param [ Hash ] options The aggregation options.
|
48
|
+
#
|
49
|
+
# @return [ Aggregation ] The aggregation object.
|
50
|
+
#
|
51
|
+
# @since 2.0.0
|
52
|
+
def aggregate(pipeline, options = {})
|
53
|
+
Aggregation.new(self, pipeline, options)
|
54
|
+
end
|
55
|
+
|
56
|
+
# Allows the query to get partial results if some shards are down.
|
57
|
+
#
|
58
|
+
# @example Allow partial results.
|
59
|
+
# view.allow_partial_results
|
60
|
+
#
|
61
|
+
# @return [ View ] The new view.
|
62
|
+
#
|
63
|
+
# @since 2.0.0
|
64
|
+
def allow_partial_results
|
65
|
+
configure_flag(:partial)
|
66
|
+
end
|
67
|
+
|
68
|
+
# The number of documents returned in each batch of results from MongoDB.
|
69
|
+
#
|
70
|
+
# @example Set the batch size.
|
71
|
+
# view.batch_size(5)
|
72
|
+
#
|
73
|
+
# @note Specifying 1 or a negative number is analogous to setting a limit.
|
74
|
+
#
|
75
|
+
# @param [ Integer ] batch_size The size of each batch of results.
|
76
|
+
#
|
77
|
+
# @return [ Integer, View ] Either the batch_size value or a
|
78
|
+
# new +View+.
|
79
|
+
#
|
80
|
+
# @since 2.0.0
|
81
|
+
def batch_size(batch_size = nil)
|
82
|
+
configure(:batch_size, batch_size)
|
83
|
+
end
|
84
|
+
|
85
|
+
# Associate a comment with the query.
|
86
|
+
#
|
87
|
+
# @example Add a comment.
|
88
|
+
# view.comment('slow query')
|
89
|
+
#
|
90
|
+
# @note Set profilingLevel to 2 and the comment will be logged in the profile
|
91
|
+
# collection along with the query.
|
92
|
+
#
|
93
|
+
# @param [ String ] comment The comment to be associated with the query.
|
94
|
+
#
|
95
|
+
# @return [ String, View ] Either the comment or a
|
96
|
+
# new +View+.
|
97
|
+
#
|
98
|
+
# @since 2.0.0
|
99
|
+
def comment(comment = nil)
|
100
|
+
configure(:comment, comment)
|
101
|
+
end
|
102
|
+
|
103
|
+
# Get a count of matching documents in the collection.
|
104
|
+
#
|
105
|
+
# @example Get the number of documents in the collection.
|
106
|
+
# collection_view.count
|
107
|
+
#
|
108
|
+
# @param [ Hash ] options Options for the count command.
|
109
|
+
#
|
110
|
+
# @option options :skip [ Integer ] The number of documents to skip.
|
111
|
+
# @option options :hint [ Hash ] Override default index selection and force
|
112
|
+
# MongoDB to use a specific index for the query.
|
113
|
+
# @option options :limit [ Integer ] Max number of docs to return.
|
114
|
+
# @option options :read [ Hash ] The read preference for this command.
|
115
|
+
#
|
116
|
+
# @return [ Integer ] The document count.
|
117
|
+
#
|
118
|
+
# @since 2.0.0
|
119
|
+
def count(options = {})
|
120
|
+
cmd = { :count => collection.name, :query => selector }
|
121
|
+
cmd[:skip] = options[:skip] if options[:skip]
|
122
|
+
cmd[:hint] = options[:hint] if options[:hint]
|
123
|
+
cmd[:limit] = options[:limit] if options[:limit]
|
124
|
+
database.command(cmd, options).n
|
125
|
+
end
|
126
|
+
|
127
|
+
# Get a list of distinct values for a specific field.
|
128
|
+
#
|
129
|
+
# @example Get the distinct values.
|
130
|
+
# collection_view.distinct('name')
|
131
|
+
#
|
132
|
+
# @param [ String, Symbol ] field_name The name of the field.
|
133
|
+
# @param [ Hash ] options Options for the distinct command.
|
134
|
+
#
|
135
|
+
# @option options :read [ Hash ] The read preference for this command.
|
136
|
+
#
|
137
|
+
# @return [ Array<Object> ] The list of distinct values.
|
138
|
+
#
|
139
|
+
# @since 2.0.0
|
140
|
+
def distinct(field_name, options={})
|
141
|
+
database.command({
|
142
|
+
:distinct => collection.name,
|
143
|
+
:key => field_name.to_s,
|
144
|
+
:query => selector },
|
145
|
+
options
|
146
|
+
).documents.first['values']
|
147
|
+
end
|
148
|
+
|
149
|
+
# The index that MongoDB will be forced to use for the query.
|
150
|
+
#
|
151
|
+
# @example Set the index hint.
|
152
|
+
# view.hint(name: 1)
|
153
|
+
#
|
154
|
+
# @param [ Hash ] hint The index to use for the query.
|
155
|
+
#
|
156
|
+
# @return [ Hash, View ] Either the hint or a new +View+.
|
157
|
+
#
|
158
|
+
# @since 2.0.0
|
159
|
+
def hint(hint = nil)
|
160
|
+
configure(:hint, hint)
|
161
|
+
end
|
162
|
+
|
163
|
+
# The max number of docs to return from the query.
|
164
|
+
#
|
165
|
+
# @example Set the limit.
|
166
|
+
# view.limit(5)
|
167
|
+
#
|
168
|
+
# @param [ Integer ] limit The number of docs to return.
|
169
|
+
#
|
170
|
+
# @return [ Integer, View ] Either the limit or a new +View+.
|
171
|
+
#
|
172
|
+
# @since 2.0.0
|
173
|
+
def limit(limit = nil)
|
174
|
+
configure(:limit, limit)
|
175
|
+
end
|
176
|
+
|
177
|
+
# Execute a map/reduce operation on the collection view.
|
178
|
+
#
|
179
|
+
# @example Execute a map/reduce.
|
180
|
+
# view.map_reduce(map, reduce)
|
181
|
+
#
|
182
|
+
# @param [ String ] map The map js function.
|
183
|
+
# @param [ String ] reduce The reduce js function.
|
184
|
+
# @param [ Hash ] options The map/reduce options.
|
185
|
+
#
|
186
|
+
# @return [ MapReduce ] The map reduce wrapper.
|
187
|
+
#
|
188
|
+
# @since 2.0.0
|
189
|
+
def map_reduce(map, reduce, options = {})
|
190
|
+
MapReduce.new(self, map, reduce, options)
|
191
|
+
end
|
192
|
+
|
193
|
+
# Set the max number of documents to scan.
|
194
|
+
#
|
195
|
+
# @example Set the max scan value.
|
196
|
+
# view.max_scan(1000)
|
197
|
+
#
|
198
|
+
# @param [ Integer ] value The max number to scan.
|
199
|
+
#
|
200
|
+
# @return [ Integer, View ] The value or a new +View+.
|
201
|
+
#
|
202
|
+
# @since 2.0.0
|
203
|
+
def max_scan(value = nil)
|
204
|
+
configure(:max_scan, value)
|
205
|
+
end
|
206
|
+
|
207
|
+
# The server normally times out idle cursors after an inactivity period
|
208
|
+
# (10 minutes) to prevent excess memory use. Set this option to prevent that.
|
209
|
+
#
|
210
|
+
# @example Set the cursor to not timeout.
|
211
|
+
# view.no_cursor_timeout
|
212
|
+
#
|
213
|
+
# @return [ View ] The new view.
|
214
|
+
#
|
215
|
+
# @since 2.0.0
|
216
|
+
def no_cursor_timeout
|
217
|
+
configure_flag(:no_cursor_timeout)
|
218
|
+
end
|
219
|
+
|
220
|
+
# The fields to include or exclude from each doc in the result set.
|
221
|
+
#
|
222
|
+
# @example Set the fields to include or exclude.
|
223
|
+
# view.projection(name: 1)
|
224
|
+
#
|
225
|
+
# @note A value of 0 excludes a field from the doc. A value of 1 includes it.
|
226
|
+
# Values must all be 0 or all be 1, with the exception of the _id value.
|
227
|
+
# The _id field is included by default. It must be excluded explicitly.
|
228
|
+
#
|
229
|
+
# @param [ Hash ] document The field and 1 or 0, to include or exclude it.
|
230
|
+
#
|
231
|
+
# @return [ Hash, View ] Either the fields or a new +View+.
|
232
|
+
#
|
233
|
+
# @since 2.0.0
|
234
|
+
def projection(document = nil)
|
235
|
+
configure(:projection, document)
|
236
|
+
end
|
237
|
+
|
238
|
+
# The read preference to use for the query.
|
239
|
+
#
|
240
|
+
# @note If none is specified for the query, the read preference of the
|
241
|
+
# collection will be used.
|
242
|
+
#
|
243
|
+
# @param [ Hash ] value The read preference mode to use for the query.
|
244
|
+
#
|
245
|
+
# @return [ Symbol, View ] Either the read preference or a
|
246
|
+
# new +View+.
|
247
|
+
#
|
248
|
+
# @since 2.0.0
|
249
|
+
def read(value = nil)
|
250
|
+
return default_read if value.nil?
|
251
|
+
configure(:read, value)
|
252
|
+
end
|
253
|
+
|
254
|
+
# Set whether the disk location should be shown for each document.
|
255
|
+
#
|
256
|
+
# @example Set show disk location option.
|
257
|
+
# view.show_disk_loc(true)
|
258
|
+
#
|
259
|
+
# @param [ true, false ] value The value for the field.
|
260
|
+
#
|
261
|
+
# @return [ true, false, View ] Either the value or a new
|
262
|
+
# +View+.
|
263
|
+
#
|
264
|
+
# @since 2.0.0
|
265
|
+
def show_disk_loc(value = nil)
|
266
|
+
configure(:show_disk_loc, value)
|
267
|
+
end
|
268
|
+
|
269
|
+
# The number of docs to skip before returning results.
|
270
|
+
#
|
271
|
+
# @example Set the number to skip.
|
272
|
+
# view.skip(10)
|
273
|
+
#
|
274
|
+
# @param [ Integer ] skip Number of docs to skip.
|
275
|
+
#
|
276
|
+
# @return [ Integer, View ] Either the skip value or a
|
277
|
+
# new +View+.
|
278
|
+
#
|
279
|
+
# @since 2.0.0
|
280
|
+
def skip(number = nil)
|
281
|
+
configure(:skip, number)
|
282
|
+
end
|
283
|
+
|
284
|
+
# Set the snapshot value for the view.
|
285
|
+
#
|
286
|
+
# @note When set to true, prevents documents from returning more than
|
287
|
+
# once.
|
288
|
+
#
|
289
|
+
# @example Set the snapshot value.
|
290
|
+
# view.snapshot(true)
|
291
|
+
#
|
292
|
+
# @param [ true, false ] value The snapshot value.
|
293
|
+
#
|
294
|
+
# @since 2.0.0
|
295
|
+
def snapshot(value = nil)
|
296
|
+
configure(:snapshot, value)
|
297
|
+
end
|
298
|
+
|
299
|
+
# The key and direction pairs by which the result set will be sorted.
|
300
|
+
#
|
301
|
+
# @example Set the sort criteria
|
302
|
+
# view.sort(name: -1)
|
303
|
+
#
|
304
|
+
# @param [ Hash ] spec The attributes and directions to sort by.
|
305
|
+
#
|
306
|
+
# @return [ Hash, View ] Either the sort setting or a
|
307
|
+
# new +View+.
|
308
|
+
#
|
309
|
+
# @since 2.0.0
|
310
|
+
def sort(spec = nil)
|
311
|
+
configure(:sort, spec)
|
312
|
+
end
|
313
|
+
|
314
|
+
private
|
315
|
+
|
316
|
+
def default_read(read = nil)
|
317
|
+
options[:read] || read_preference
|
318
|
+
end
|
319
|
+
|
320
|
+
def flags
|
321
|
+
@flags ||= (!primary? ? [ :slave_ok ] : [])
|
322
|
+
end
|
323
|
+
|
324
|
+
def has_special_fields?
|
325
|
+
sort || hint || comment || max_scan || show_disk_loc || snapshot || explained? || cluster.sharded?
|
326
|
+
end
|
327
|
+
|
328
|
+
def primary?
|
329
|
+
read.name == :primary
|
330
|
+
end
|
331
|
+
|
332
|
+
def query_options
|
333
|
+
{ :project => projection, :skip => skip, :limit => to_return, :flags => flags }
|
334
|
+
end
|
335
|
+
|
336
|
+
def query_spec
|
337
|
+
sel = has_special_fields? ? special_selector : selector
|
338
|
+
{ :selector => sel,
|
339
|
+
:read => read,
|
340
|
+
:options => query_options,
|
341
|
+
:db_name => database.name,
|
342
|
+
:coll_name => collection.name }
|
343
|
+
end
|
344
|
+
|
345
|
+
def read_pref_formatted
|
346
|
+
read.to_mongos
|
347
|
+
end
|
348
|
+
|
349
|
+
def special_selector
|
350
|
+
SPECIAL_FIELDS.reduce({}) do |hash, (key, method)|
|
351
|
+
value = send(method)
|
352
|
+
hash[key] = value if value
|
353
|
+
hash
|
354
|
+
end
|
355
|
+
end
|
356
|
+
|
357
|
+
def to_return
|
358
|
+
[ limit || batch_size, batch_size || limit ].min
|
359
|
+
end
|
360
|
+
end
|
361
|
+
end
|
362
|
+
end
|
363
|
+
end
|
@@ -0,0 +1,169 @@
|
|
1
|
+
# Copyright (C) 2014-2015 MongoDB, Inc.
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
module Mongo
|
16
|
+
class Collection
|
17
|
+
class View
|
18
|
+
|
19
|
+
# Defines write related behaviour for collection view.
|
20
|
+
#
|
21
|
+
# @since 2.0.0
|
22
|
+
module Writable
|
23
|
+
|
24
|
+
# Finds a single document in the database via findAndModify and deletes
|
25
|
+
# it, returning the original document.
|
26
|
+
#
|
27
|
+
# @example Find one document and delete it.
|
28
|
+
# view.find_one_and_delete
|
29
|
+
#
|
30
|
+
# @return [ BSON::Document, nil ] The document, if found.
|
31
|
+
#
|
32
|
+
# @since 2.0.0
|
33
|
+
def find_one_and_delete
|
34
|
+
cmd = { :findandmodify => collection.name, :query => selector, :remove => true }
|
35
|
+
cmd[:fields] = projection if projection
|
36
|
+
cmd[:sort] = sort if sort
|
37
|
+
database.command(cmd).first['value']
|
38
|
+
end
|
39
|
+
|
40
|
+
# Finds a single document and replace it.
|
41
|
+
#
|
42
|
+
# @example Find a document and replace it, returning the original.
|
43
|
+
# view.find_one_and_replace({ name: 'test' }, :return_document => :before)
|
44
|
+
#
|
45
|
+
# @example Find a document and replace it, returning the new document.
|
46
|
+
# view.find_one_and_replace({ name: 'test' }, :return_document => :after)
|
47
|
+
#
|
48
|
+
# @param [ BSON::Document ] document The updates.
|
49
|
+
# @param [ Hash ] opts The options.
|
50
|
+
#
|
51
|
+
# @option opts [ Symbol ] :return_document Either :before or :after.
|
52
|
+
# @option opts [ true, false ] :upsert Whether to upsert if the
|
53
|
+
# document doesn't exist.
|
54
|
+
#
|
55
|
+
# @return [ BSON::Document ] The document.
|
56
|
+
#
|
57
|
+
# @since 2.0.0
|
58
|
+
def find_one_and_replace(replacement, opts = {})
|
59
|
+
find_one_and_update(replacement, opts)
|
60
|
+
end
|
61
|
+
|
62
|
+
# Finds a single document and updates it.
|
63
|
+
#
|
64
|
+
# @example Find a document and update it, returning the original.
|
65
|
+
# view.find_one_and_update({ "$set" => { name: 'test' }}, :return_document => :before)
|
66
|
+
#
|
67
|
+
# @param [ BSON::Document ] document The updates.
|
68
|
+
# @param [ Hash ] opts The options.
|
69
|
+
#
|
70
|
+
# @option opts [ Symbol ] :return_document Either :before or :after.
|
71
|
+
#
|
72
|
+
# @return [ BSON::Document ] The document.
|
73
|
+
#
|
74
|
+
# @since 2.0.0
|
75
|
+
def find_one_and_update(document, opts = {})
|
76
|
+
cmd = { :findandmodify => collection.name, :query => selector }
|
77
|
+
cmd[:update] = document
|
78
|
+
cmd[:fields] = projection if projection
|
79
|
+
cmd[:sort] = sort if sort
|
80
|
+
cmd[:new] = (opts[:return_document] == :after ? true : false) if opts[:return_document]
|
81
|
+
cmd[:upsert] = opts[:upsert] if opts[:upsert]
|
82
|
+
database.command(cmd).first['value']
|
83
|
+
end
|
84
|
+
|
85
|
+
# Remove documents from the collection.
|
86
|
+
#
|
87
|
+
# @example Remove multiple documents from the collection.
|
88
|
+
# collection_view.remove_many
|
89
|
+
#
|
90
|
+
# @return [ Result ] The response from the database.
|
91
|
+
#
|
92
|
+
# @since 2.0.0
|
93
|
+
def remove_many
|
94
|
+
remove(0)
|
95
|
+
end
|
96
|
+
|
97
|
+
# Remove a document from the collection.
|
98
|
+
#
|
99
|
+
# @example Remove a single document from the collection.
|
100
|
+
# collection_view.remove_one
|
101
|
+
#
|
102
|
+
# @return [ Result ] The response from the database.
|
103
|
+
#
|
104
|
+
# @since 2.0.0
|
105
|
+
def remove_one
|
106
|
+
remove(1)
|
107
|
+
end
|
108
|
+
|
109
|
+
# Replaces a single document in the database with the new document.
|
110
|
+
#
|
111
|
+
# @example Replace a single document.
|
112
|
+
# collection_view.replace_one({ name: 'test' })
|
113
|
+
#
|
114
|
+
# @param [ Hash ] document The document to replace.
|
115
|
+
#
|
116
|
+
# @return [ Result ] The response from the database.
|
117
|
+
#
|
118
|
+
# @since 2.0.0
|
119
|
+
def replace_one(document)
|
120
|
+
update(document, false)
|
121
|
+
end
|
122
|
+
|
123
|
+
# Update documents in the collection.
|
124
|
+
#
|
125
|
+
# @example Update multiple documents in the collection.
|
126
|
+
# collection_view.update_many('$set' => { name: 'test' })
|
127
|
+
#
|
128
|
+
# @return [ Result ] The response from the database.
|
129
|
+
#
|
130
|
+
# @since 2.0.0
|
131
|
+
def update_many(spec)
|
132
|
+
update(spec, true)
|
133
|
+
end
|
134
|
+
|
135
|
+
# Update a single document in the collection.
|
136
|
+
#
|
137
|
+
# @example Update a single document in the collection.
|
138
|
+
# collection_view.update_one('$set' => { name: 'test' })
|
139
|
+
#
|
140
|
+
# @return [ Result ] The response from the database.
|
141
|
+
#
|
142
|
+
# @since 2.0.0
|
143
|
+
def update_one(spec)
|
144
|
+
update(spec, false)
|
145
|
+
end
|
146
|
+
|
147
|
+
private
|
148
|
+
|
149
|
+
def remove(value)
|
150
|
+
Operation::Write::Delete.new(
|
151
|
+
:delete => { q: selector, limit: value },
|
152
|
+
:db_name => collection.database.name,
|
153
|
+
:coll_name => collection.name,
|
154
|
+
:write_concern => collection.write_concern
|
155
|
+
).execute(next_primary.context)
|
156
|
+
end
|
157
|
+
|
158
|
+
def update(spec, multi)
|
159
|
+
Operation::Write::Update.new(
|
160
|
+
:update => { q: selector, u: spec, multi: multi, upsert: false },
|
161
|
+
:db_name => collection.database.name,
|
162
|
+
:coll_name => collection.name,
|
163
|
+
:write_concern => collection.write_concern
|
164
|
+
).execute(next_primary.context)
|
165
|
+
end
|
166
|
+
end
|
167
|
+
end
|
168
|
+
end
|
169
|
+
end
|